Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Фатальні зупинки

Фатальна зупинка — це помилка під час компіляції, яка зупиняє збирання до того, як буде створено будь-який вихідний результат. Кожна зупинка називає файл, сутність і поле, у яких виникла проблема, пояснює, що компілятор не зміг розв’язати, і вказує на конкретну зміну в авторському коді, яка це виправляє. Компілятор ніколи мовчки не виправляє і не переписує ваші вхідні дані — якщо щось не так, збирання зупиняється і повідомляє вам, де саме.

Цей каталог упорядковано за етапами компіляції, на яких спрацьовує кожна зупинка.

Кожен запис нижче наводить повідомлення, яке збирання виводить для описаної в ньому умови: незмінне речення, що формулює умову, а потім усе, що надала конкретна поява помилки. У терміналі це повідомлення з’являється всередині рамки — заголовка у квадратних дужках із категорією та коротким кодом умови, вказівника на файл і ключ, у яких виникла проблема, за яким іде екземпляр, якого стосується збій, у формі (instance <name>) (або, якщо файл не застосовний, лише цей екземпляр у формі instance <name>), і повідомлення на рядку нижче, — тож цілий рядок, скопійований зі збирання, не збігатиметься із записом тут, а повідомлення всередині нього збігатиметься; повний опис рамки наведено в error-translation.md.

Якщо ви прийшли зі збирання з коротким кодом — літерою E і чотирма цифрами в заголовку діагностики у квадратних дужках, — почніть із розділу Пошук зупинки за коротким кодом, який вивело збирання наприкінці цієї сторінки: там кожна описана тут умова наведена разом із коротким кодом, який для неї виводить збирання.

Під час завантаження ваших файлів

Компілятор читає кожну сутність Aggregate, Manifest, Component, Feature, Recipe, FeatureRecipe, Plugin і Release, на яку посилається ваша збірка, перевіряє кожну на відповідність її схемі та інтерполює типізовані параметри з Release в Aggregate.

YAML anchor aliased inside its own content (Якір YAML використано як псевдонім усередині його власного вмісту)

Документ позначає вузол якорем &name, а потім посилається на нього псевдонімом *name десь усередині вмісту, який цей якір охоплює. Розгортання псевдоніма відтворює якір, вміст якого знову містить псевдонім, тож документ описує структуру без кінця. Немає нічого скінченного, що можна було б прочитати, не кажучи вже про перевірку, і збірка зупиняється замість того, щоб розпочати обхід, який не може завершитися.

Читання YAML у дерево не розгортає псевдоніми, тому документ такої форми читається без зауважень і дає збій лише тоді, коли щось його обходить. Тож відмова розташована між читанням і обходом — а збірка читає написаний YAML у кількох місцях, тому ту саму умову можна зустріти в кількох місцях. Про неї повідомляють чотири місця, і кожне обрамлює те саме пояснення тим, що визначає розташування документа на цьому рівні:

  • Файл сутності під час читання. Збірка зупиняється до перевірки цієї сутності на відповідність її схемі, тому ця зупинка називає якір, а не поле, і не містить рядка та стовпця: на цьому етапі документ не має позиції, на яку діагностика могла б корисно вказати.
  • Тіло схеми під час компіляції. Стовп spec.schema: компілюється з компактної форми в документ JSON Schema після того, як його файл прочитано, тому ця зупинка спрацьовує під час цієї компіляції, а не перед нею, і вона містить рядок. Форма, яку попереднє читання не може виявити, — це тіло запасного виходу $jsonschema:: тіло запасного виходу є блоковим скаляром — звичайним текстом без якорів — поки читається навколишній файл, і його якорі стають якорями лише тоді, коли сам цей текст розбирається, на рівень нижче. Якщо цикл був усередині такого блоку, зупинка також називає $jsonschema як ключове слово, тіло якого його містило.
  • Схема робочого навантаження Plugin постачальника під час завантаження Plugin. spec.provider.workloadSchema записується як блоковий скаляр: це звичайний текст, поки читається сам файл Plugin, без якорів на цьому етапі, і його якорі стають якорями лише тоді, коли цей текст розбирається як окремий документ, на рівень нижче. Цей розбір і компіляція, що йде за ним, відбуваються під час завантаження Plugin, тому ця зупинка спрацьовує саме тоді, а не під час читання файлу, і вона містить рядок. Якщо цикл був усередині запасного виходу $jsonschema: у тілі схеми, зупинка також називає $jsonschema як ключове слово, тіло якого його містило. Опис написання цього поля див. у ../entities/plugin.md.
  • Відрендерений фрагмент CloudFormation під час читання постачальником. Recipe для cloudformation описує фрагмент, а тіло artifacts: є шаблоном — тож постачальник читає текст, у який відрендерився цей шаблон, тобто вміст, якого не існувало, поки читалися ваші файли. Тому ця зупинка спрацьовує під час рендерингу виводу, коли всі перевірки схем уже пройдено. Опис написання фрагментів див. у ../providers/cloudformation.md.

Відмова стосується рекурсії, а не повторного використання чи глибини. Позначення спільного вмісту якорем і посилання на нього з багатьох місць — підтримуваний шаблон написання (див. ../entities/aggregate.md «YAML anchor patterns (defs: block)» і ../entities/manifest.md «YAML anchors for DRY manifests»), а посилання, яке розгортається і завершується, завантажується звичайно, скільки б разів воно не траплялося і як би глибоко не був вкладений документ; глибина сама по собі ніколи не є причиною цієї зупинки. Зупинку спричиняє якір, досягнутий тоді, коли збірка ще перебуває всередині нього, зокрема коли його досягнуто опосередковано, через другий якір, оголошений під ним. Повідомлення називає якір, на який замикається цикл, і це не обов’язково найзовнішній якір у документі.

Повідомлення, що виводяться. Усі чотири містять однакове пояснення, і це зроблено навмисно: це одна умова, зустрінута в чотирьох місцях, і автор, який раз навчився її читати, не повинен вчитися знову. Відрізняється лише обрамлення, що визначає розташування документа.

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 (на якір посилається аліас усередині його власного вмісту, тож документ розгортається без кінця; спрямуйте цей аліас на вміст, оголошений поза цим якорем, або випишіть вміст повністю)

Файл сутності обрамлюється перевіркою оболонки, яка його читала, і шляхом, з якого його прочитано:

document envelope validation failed: envelope: parse <path>: <the explanation above> (перевірка оболонки документа не вдалася: envelope: розбір <path>: <the explanation above>)

Тіло схеми обрамлюється його позицією в схемі, а також ключовим словом запасного виходу, якщо цикл був усередині блоку $jsonschema:. Збірка повідомляє про це з тегом CATALOG_ERROR, який також називає файл, сутність і стовп, тіло якого не вдалося скомпілювати:

compactform at <schema-path>:<line> (keyword "$jsonschema"): <the explanation above>

Схема робочого навантаження Plugin постачальника має те саме обрамлення компактної форми; відрізняється тег CATALOG_ERROR навколо нього, який називає Plugin і spec.provider.workloadSchema замість сутності та її стовпа.

Відрендерений фрагмент обрамлюється постачальником, який його прочитав:

cloudformation-provider: parse fragment: <the explanation above> (cloudformation-provider: розбір фрагмента: <the explanation above>)

Як виправити: спрямуйте псевдонім на вміст, оголошений поза якорем, усередині якого він зараз розташований, або випишіть повторюваний вміст повністю в місці використання. У сутності Aggregate або Manifest природним місцем для спільних якорів є блок defs: кореневого рівня — він розташований поза кожним блоком, що на нього посилається, тож оголошений там якір неможливо досягти зсередини нього самого. В інших видах сутностей, які не мають блоку defs:, позначайте спільний вміст якорем у такому місці, нащадком якого блок, що посилається, не є. На якір можна посилатися з будь-якої кількості місць і з будь-якої глибини; єдина форма, якої воно не може набути, — посилання, що потрапляє назад усередину вмісту, охопленого якорем.

Те саме виправлення застосовується, де б не було зустрінуто зупинку, а обрамлення підказує, який документ відкрити: сам файл сутності, блок $jsonschema: усередині стовпа схеми, тіло workloadSchema у Plugin постачальника або тіло artifacts:, відрендерений вивід якого прочитав постачальник. В останньому випадку якір міститься в написаному вами шаблоні, а не у відрендереному тексті — рендеринг лише точно його відтворив.

Parameter type mismatch / contract violation (Невідповідність типу параметра / порушення контракту)

Release надав значення, тип або форма якого не відповідає тому, що Aggregate оголосив для цього параметра. Валідатор контрактів параметрів виявляє невідповідності типів, порушення enum, порушення діапазону, порушення шаблону, рядки, що не є коректними екземплярами оголошеного для них format, невдачі предиката validate: і відсутні обов’язкові параметри ще до виконання будь-якої інтерполяції шаблонів. Назви, які може набувати format, і те, що перевіряє кожна з них, наведено в розділі Іменовані формати.

Повідомлення, що виводиться, — речення, яке формулює умову, потім сутність, у якій помилка, шлях до поля та подробиці обмеження:

parameter contract violated (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" expected type <declared type>; got <received type>) (контракт параметра порушено (Aggregate, у .spec.parameters.<parameter>, параметр “<parameter>” очікував тип <declared type>; отримано <received type>))

Для параметра, оголошеного як required: true без default: і без значення, наданого Release, звіт містить іншу умову та інший короткий код:

required parameter not supplied (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" is required but not supplied by Release) (обов’язковий параметр не надано (Aggregate, у .spec.parameters.<parameter>, параметр “<parameter>” обов’язковий, але Release його не надав))

Залежно від невиконаного обмеження змінюються лише подробиці після шляху до поля. Речення та обрамлення в дужках навколо нього щоразу однакові, тож саме речення слід зіставляти, а подробиці — читати. Подробиці, які виводить збірка, по одній для кожного виду обмеження:

parameter "<parameter>" value <value> not in enum [<members>] (значення параметра немає в enum) parameter "<parameter>" value "<value>" does not match pattern "<pattern>" (значення параметра не відповідає шаблону) parameter "<parameter>" value "<value>" is not a valid <format>: <reason> (значення параметра не є коректним форматом) parameter "<parameter>" value <value> above max <max> (значення параметра перевищує максимум) parameter "<parameter>" failed validate predicate (параметр не пройшов предикат validate) parameter "<parameter>" validate predicate error: <detail> (помилка предиката validate параметра)

<reason> невдачі формату пояснює, що не так зі значенням, у термінах самого цього формату. Значення всередині вкладеного контракту називається своїм шляхом, тож format, оголошений контрактом items:, перевіряється для кожного елемента, і звіт називає той, що не пройшов перевірку: другий елемент параметра hosts повідомляється в .spec.parameters.hosts.1, а його подробиці називають "hosts.1".

Параметр, що оголошує validateMessage:, замінює всі ці подробиці власним текстом, тож звіт має вигляд parameter contract violated (Aggregate, at .spec.parameters.<parameter>, <the validateMessage you wrote>) — обрамлення не змінюється, а ваше речення стоїть там, де були б подробиці обмеження.

Та сама умова охоплює контракт, який у написаному вигляді не може нічого обмежити. pattern:, що не є коректним регулярним виразом, відхиляється під час читання контракту параметрів Aggregate, ще до перевірки будь-якого значення Release, тож він зупиняє збірку незалежно від того, чи надає Release цей параметр. Звіт указує на ключ — .spec.parameters.<parameter>.pattern або шлях через вкладений контракт, як-от .spec.parameters.<parameter>.items.pattern, — а його подробиці називають оголошення, шаблон і причину:

parameter "<parameter>" pattern "<pattern>" does not compile: <reason> (шаблон параметра не компілюється)

format:, що називає формат поза підтримуваним набором, теж не може нічого обмежити, і він відхиляється на тому ж етапі, до перевірки будь-якого значення Release, тож він так само зупиняє збірку незалежно від того, чи надає Release цей параметр. Усередині вкладеного контракту — під items:, properties: або valuesType: — його відхиляє саме ця умова: звіт указує на ключ, як-от .spec.parameters.<parameter>.items.format, а його подробиці називають оголошення, формат у написаному вигляді та кожну підтримувану назву:

parameter "<parameter>.items": format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date (параметр: формат не підтримується; підтримувані формати: email, uri, hostname, ipv4, ipv6, uuid, date-time, date)

У власному оголошенні параметра та сама назва відхиляється на крок раніше — схемою Aggregate, чий format допускає лише підтримувані назви. Ця відмова означає, що документ не відповідає схемі свого виду, — це інша умова з власним коротким кодом E0215, і aggrega pull та aggrega validate --release виводять її після повідомлення про те, що посилання aggregate: у Release неможливо розв’язати (E0170), оскільки Aggregate з цією назвою не завантажився:

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 (перевірка оболонки документа не вдалася (Aggregate, у файлі): format не дорівнює жодному з: [email uri hostname ipv4 ipv6 uuid date-time date]. виправте документ відповідно до схеми його виду)

Подробиці помилки предиката охоплюють обидва способи, у які предикат validate: може не дати вердикту: функцію, яку середовище не реєструє, і посилання на щось інше, ніж .value. Про кожен із них повідомляється стосовно предиката, а не значення, і кожен називає те, що не вдалося розв’язати.

Предикат validate: читає значення, що перевіряється, як .value, і це єдина назва, яку він визначає. Предикат, що називає будь-що інше, відхиляється ще до виконання, тож помилкове посилання повідомляється як помилка в назві, якою воно і є, а не розв’язується в ніщо й не постає як значення, що не пройшло перевірку.

Як виправити: змініть значення Release відповідно до оголошених обмежень параметра type / enum / min / max / pattern / format, надайте відсутній обов’язковий параметр, виправте pattern:, що не компілюється, замініть format:, який називає непідтримуваний формат, одним з іменованих форматів або видаліть його, виправте предикат validate:, який називає щось інше, ніж .value, або рендерить щось інше, ніж true чи false, або розширте оголошення в Aggregate, щоб воно приймало форму, яка вам насправді потрібна.

Правила форми Recipe

Recipe складає свій вивід із трьох видів вхідних даних — sourced, synthesized і artifacts, — описаних у ../../architecture/16-recipe-input-composition.md. Форму коректного Recipe обмежують наведені нижче правила композиції. Вони відрізняються тим, коли їх перевіряють — під час завантаження Recipe, під час рендерингу вузла чи під час виведення результату, — тож у кожному записі дивіться, на якому етапі перевіряється його власна умова.

Кожне правило назване за тим, що воно обмежує. Нумерації немає, і жоден номер не зарезервовано: назва вказує, яку частину Recipe відкрити, і продовжує це вказувати, хоч би як список нижче розростався чи змінював порядок. Якщо умову потрібно зафіксувати надовго — у CI-перевірці, задачі, runbook, — використовуйте її код: ідентифікатор, який sentinels.md наводить для цієї умови і який залишається незмінним, хоч би як розвивалися пакети навколо нього.

Зупинка через форму Recipe складається так само. Вона починається реченням, що формулює правило, далі називає, що саме надав цей Recipe, а потім подає деталі, специфічні для нього:

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

Початкове речення фіксоване для кожного правила — той самий текст щоразу, коли це правило зупиняє збірку, незалежно від етапу, на якому його виявлено, — тож саме з цією частиною виводу слід зіставляти, і саме цей текст sentinels.md наводить для умови правила. Усе, що йде після нього, залежить від Recipe, у якому помилка: значення в дужках вказують, який документ, яке правило за назвою і де, а завершальне речення — порада для цього випадку. Позиція — це файл, з якого завантажено Recipe, коли правило стосується документа загалом, і шлях через крапки до ключа, який ви написали, — .spec.outputComponentLabels.hosting, — коли правило стосується чогось усередині нього; ключ, що сам містить крапки, не можна записати як ще один сегмент, щоб він не читався так само як два, тому шлях зупиняється на блоці, що його містить, а порада натомість цитує ключ.

Збірка друкує весь рядок під тегом CATALOG_ERROR, який означає, що збій пов’язаний із сутністю каталогу (Recipe або провайдером, до якого він прив’язаний), а не з Aggregate чи Release. Поруч із тегом друкується файл, з якого завантажено Recipe, тож навіть правило, позиціоноване на ключі, підказує, який файл відкрити.

valuesMapping потребує source

Recipe оголошує valuesMapping, але не source. Без джерела, на яке накладаються значення, немає чого отримати зіставлені значення. Це правило перевіряється під час завантаження Recipe.

Повідомлення, що виводиться:

Recipe: valuesMapping requires source (Recipe <name>:<version>, rule values-mapping, at <path>). declare a source: pointer alongside valuesMapping (or remove the valuesMapping if no overlay is intended) (Recipe: valuesMapping потребує source (сутність Recipe, правило values-mapping, у вказаному шляху). оголосіть вказівник source: поруч із valuesMapping (або видаліть valuesMapping, якщо накладання не передбачено))

Як виправити: додайте вказівник source: (посилання на chart, модуль або compose-файл) поруч із valuesMapping або видаліть valuesMapping і перейдіть на інший вид вхідних даних (workload: для синтезованого виводу, artifacts: для прямого виведення маніфестів).

workload: потребує провайдера, здатного до синтезу

Recipe оголошує workload: (синтезований режим) для провайдера, який не реалізує синтез Workload. Підтримка синтезованого режиму — властивість провайдера: каталог стандартної бібліотеки за домовленістю оголошує workloadSchema для провайдерів, здатних до синтезу, але перевірка спирається на можливості провайдера, а не на наявність цього поля.

Про це повідомляють дві поверхні, і лише одна з них визначає долю збірки. Зупинка відбувається під час рендерингу, після прив’язки провайдера вузла й прочитання видів вхідних даних, які оголошує його Recipe, тому це повідомлення називає вузол. aggrega validate повідомляє про те саме раніше, до прив’язки будь-якого вузла, читаючи Recipe окремо, — тому його повідомлення натомість називає Recipe та його версію. Вони читають різні набори Recipes: раннє повідомлення виникає для будь-якого Recipe, що взагалі оголошує workload:, тоді як зупинка виникає для кожного виду вхідних даних, оголошеного вузлом, який його провайдер не може обробити. Тож Recipe, що поєднує workload: із source:, однаково зупиняє збірку, і саме через workload — оголошення виду вхідних даних, який провайдер може відрендерити, не проводить непідтримуваний вид через перевірку.

Єдине обмеження цього: artifacts: перевіряється на підтримку автономних артефактів лише тоді, коли це єдиний оголошений вид вузла. Поруч із source: або workload: його файли проходять як складений вивід, на який ця можливість не поширюється.

Повідомлення, що виводиться під час рендерингу. Категорія, до якої віднесено збій, з’являється у квадратних дужках на початку діагностики, а не всередині повідомлення. Повідомлення починається фіксованим реченням, що формулює умову, далі називає вузол, провайдера, відхилений оголошений вид і види, які цей провайдер підтримує. Якщо вузол оголошує два види, які його провайдер не може обробити, повідомляється перший у порядку source → workload → artifacts, тож результат стосується одного рядка вашого Recipe:

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> (провайдер не підтримує вид вхідних даних вузла (вказаний вузол). вказаний провайдер не підтримує рецепти цього режиму (провайдер підтримує лише перелічені види); оголосіть один із підтримуваних видів вхідних даних або оберіть провайдер, який підтримує цей режим)

Заголовок містить категорію та короткий код цієї умови, E0265, — саме цей ідентифікатор слід фіксувати, коли зупинку потрібно назвати надовго: у перевірці безперервної інтеграції, задачі чи runbook. Номер видається один раз і потім не змінюється, тож він лишається тим самим, хоч би як покращувалося формулювання довкола нього; таблиця всіх умов його розшифровує, а початкове речення вище — те, з чим слід зіставляти, коли ви працюєте з текстом, а не з ідентифікатором.

aggrega validate повідомляє те саме положення під Recipe, що містить блок, з префіксом поверхні, яка його прочитала, і з коротким кодом цієї умови на початку, бо раннє повідомлення стосується тієї самої умови:

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: вказаний провайдер не підтримує синтезовані рецепти (провайдер підтримує лише перелічені види); оголосіть один із підтримуваних видів вхідних даних або оберіть провайдер, який підтримує синтез)

Для всього каталогу це один рядок; з --release заголовок стоїть в окремому рядку над положенням. Діагностика редактора для тієї самої знахідки має код E0265.

Як виправити: прив’яжіть Recipe до провайдера, що виконує синтез (найчастіше helm або compose), або переведіть Recipe на інший вид вхідних даних (artifacts: для прямого виведення маніфестів або source: + valuesMapping:, якщо існує chart/модуль).

Валідація вмісту Workload для кожного провайдера. Наразі workloadSchema провайдера є лише документацією і не валідує тіло Workload; тіла валідуються за вбудованою схемою Workload, якою володіє платформа. Коли з’явиться синтезатор Workload на основі Wasm, workloadSchema стане контрактом окремого провайдера, за яким синтезатор валідуватиме тіло Workload (окрема зупинка на рівні вмісту).

The provider does not support omits (Провайдер не підтримує omits)

Сутність Recipe або FeatureRecipe оголошує omits:, а провайдер, який її рендерить, не оголошує, що він вилучає відрендерені документи. Вилучити документ із того, що рендерить джерело, може лише провайдер — лише провайдер знає, які документи рендерить джерело і як кожен із них називається, — тож провайдер, який цього не робить, відрендерив би кожен документ, названий у записах, і повідомив би про успіх. Натомість збірка відмовляє ще до будь-якого рендерингу, щоб ключ ніколи непомітно не залишався без дії.

Чи вилучає провайдер документи, визначається з власного оголошення провайдера про те, що він підтримує, а не зі списку провайдерів, який веде компілятор. Враховується кожен запис, хоч би що рендерив його when:, бо здатність провайдера виконати ключ не залежить від того, які записи залишає збірка. Провайдери helm, compose і cloudformation виконують цей ключ. helm-chart і terraform передають своє джерело на рендеринг під час розгортання, тож під час збірки не існує відрендереного документа, який можна було б вилучити, і обидва отримують відмову.

Рішення про відмову ухвалюється, щойно прив’язано Recipe кожного компонента та FeatureRecipe кожного приєднання і кожен провайдер описав себе, — до рендерингу першого компонента і до обчислення будь-якого запису, тож збірка, якій тут відмовлено, нічого не рендерить. Перевірка стосується кожного документа, що рендерить джерело: Recipe компонента; FeatureRecipe, яку приєднання прив’язує до компонента, — один раз для кожного компонента з цим приєднанням; і FeatureRecipe, що генерується один раз для межі, — один раз, на межі, яка її оголошує. Про кожен помилковий документ повідомляється в одній збірці; якщо їх кілька, знахідки групуються під documents declaring omits whose provider does not honour them. Документ, прив’язаний до провайдера, якого збірка не може розв’язати, тут не повідомляється: така збірка зупиняється там, де вибирається провайдер, із зазначенням прив’язки.

Повідомлення, що виводиться, розташоване на власному ключі компонента в components: для записів Recipe (для компонента, записаного всередині підсистеми, спершу вказується ключ цієї підсистеми), на ключі приєднання в блоці features:, що його записав, для записів FeatureRecipe на компоненті, і на .spec.boundaries.<boundary>.features.<attachment> у сутності Release для FeatureRecipe, що генерується один раз для своєї межі. Категорія надходить у заголовку у квадратних дужках; повідомлення спершу називає провайдера, потім компонент, для якого рендериться документ:

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 (провайдер не підтримує omits: контракт цього провайдера не оголошує, що він пропускає відрендерені документи; вилучіть ключ omits або рендерте джерело через провайдер, контракт якого це оголошує)

Знахідка для FeatureRecipe називає приєднання після компонента — node "<node-id>", attachment "<attachment>", — а та, що генерується один раз для своєї межі, називає межу й приєднання замість компонента: boundary "<boundary>", attachment "<attachment>".

Заголовок містить короткий код цієї умови, E0335.

Як виправити: видаліть ключ omits: або рендерте джерело через провайдера, який його виконує. Якщо сутність Recipe для helm-chart чи terraform бере за джерело локальний чарт або модуль, рядок у .aggregaignore поруч із Recipe натомість вилучає файл цього джерела, починаючи з наступного закріплення Recipe, — див. aggrega pin.

The provider does not support boundary artifacts (Провайдер не підтримує артефакти межі)

Сутність Recipe оголошує spec.boundary.artifacts — файли для спільного виводу межі, у якій вона рендериться, — а провайдер, який її рендерить, не оголошує, що приймає такі файли. Компілятор записує ці файли сам, поруч із тим, що провайдер збирає для межі, і не передає провайдеру жодного з них, тож чи має сенс файл, розміщений там, — це властивість цілі провайдера. Ціль, яка його не читає, постачила б його й проігнорувала, і конфігурація в ньому ніколи б не набула чинності; натомість збірка відмовляє ще до будь-якого рендерингу.

Чи приймає провайдер ці файли, визначається з власного оголошення провайдера про те, що він підтримує, а не зі списку провайдерів, який веде компілятор. Враховується будь-який запис, хоч би на що він рендерився. Провайдер terraform їх приймає, записуючи кожен поруч із кореневою конфігурацією межі; helm, compose, helm-chart і cloudformation — ні, і отримують відмову.

Рішення про відмову ухвалюється, щойно прив’язано Recipe кожного компонента і кожен провайдер описав себе, — до рендерингу першого компонента і до обчислення будь-якого запису, тож збірка, якій тут відмовлено, нічого не рендерить. Про кожну помилкову сутність Recipe повідомляється в одній збірці, один раз для кожного компонента, який вона рендерить; якщо знахідок кілька, вони групуються під Recipes declaring boundary artifacts whose provider does not accept them. Сутність Recipe, прив’язана до провайдера, якого збірка не може розв’язати, тут не повідомляється: така збірка зупиняється там, де вибирається провайдер, із зазначенням прив’язки.

Повідомлення, що виводиться, розташоване на .spec.boundary у сутності Recipe, де й потрібне редагування. Категорія надходить у заголовку у квадратних дужках; повідомлення спершу називає провайдера, потім компонент, для якого рендериться 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 (провайдер не підтримує артефакти межі: контракт цього провайдера не оголошує, що він приймає файли, записані до спільного виводу межі; вилучіть блок boundary або рендерте Recipe через провайдер, контракт якого це оголошує)

Заголовок містить короткий код цієї умови, E0351.

Як виправити: видаліть блок boundary: або рендерте Recipe через провайдера, який його приймає. Файл, що належить компоненту, а не межі, натомість є записом artifacts:.

At least one input kind must be present (Має бути присутній щонайменше один вид вхідних даних)

Сутність Recipe не оголошує жодного виду вхідних даних: немає source у парі з valuesMapping, немає workload:, немає artifacts:. Така Recipe не створює виводу й не має поверхні рендерингу. Це правило перевіряється під час завантаження Recipe.

Файл Recipe такої форми спершу стикається зі схемою Recipe: схема на кожному провайдері вимагає одного з source, valuesMapping, workload або artifacts, тож перевірка оболонки документа відхиляє файл з E0215 ще до запуску цього правила, по одній гілці на кожен ключ:

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 (валідація оболонки документа не пройшла (Recipe): spec: не збіглася жодна гілка anyOf: у гілці 0 бракує обов’язкової властивості “source”; у гілці 1 бракує обов’язкової властивості “valuesMapping”; у гілці 2 бракує обов’язкової властивості “workload”; у гілці 3 бракує обов’язкової властивості “artifacts”. Виправте документ, щоб він відповідав схемі свого виду)

Повідомлення, що виводиться:

Recipe: at least one input kind required (Recipe <name>:<version>, rule input-kinds, at <path>). declare one of: source (with valuesMapping), workload, artifacts (Recipe: потрібен принаймні один вид вхідних даних; оголосіть один із: source (разом із valuesMapping), workload, artifacts)

Як виправити: додайте вид вхідних даних, що відповідає задуму автора Recipe. Recipe для сервісу, який збирання не розгортає, — бази даних чи API, що вже працюють деінде, — оголошує workload: з form: reference та його endpoint (і, за потреби, port) і публікує свої значення підключення в provides:, як будь-який Recipe: helm рендерить його як ExternalName Service, compose нічого для нього не рендерить, і на обох його споживачі читають опубліковані значення.

Ключі записів artifacts: мають бути унікальними

Сутність Recipe оголошує два або більше записів у artifacts: з однаковим ключем. Ключ визначає ім’я файлу, що виводиться (незалежно від того, чи тіло запису написано вбудовано, чи завантажено через $import: окремого запису); дублікати ключів вивели б файл з однаковим ім’ям до того самого каталогу межі.

Збірка відхиляє Recipe під час декодування документа в його типізовану форму, називаючи повторений ключ і рядок, у якому він повторюється. Цей крок виконується після перевірки схеми обгортки і перед правилами форми, тож Recipe з дублікатом ключа artifacts: повідомляє про коректну схему, а потім про цю зупинку, і решта правил форми про неї не повідомляють.

Як виправити: перейменуйте один із конфліктних ключів записів, щоб кожен запис artifacts: мав унікальне ім’я файлу.

Emission-time filename collision across input kinds (Колізія імен файлів між видами вхідних даних під час виведення)

І Recipe, і FeatureRecipe оголошують види вхідних даних, що створюють файли: source:, який рендерить провайдер, workload:, який провайдер синтезує, записи artifacts: і pipeline:, кроки якого можуть виводити файли. Кожен із них обирає імена виводу незалежно від інших, і ніщо не оголошує ці імена різними, тож два з них можуть створити файл під одним іменем, і зберігся б лише один із двох. Збірка зупиняється й називає ім’я виводу разом з усіма блоками, що його створили.

Перевірка виконується один раз для кожного документа, що виводить файли, щойно завершено власне виведення цього документа і до того, як його вивід потрапить до будь-якого збирання. Виводять три документи, і кожен перевіряється окремо: власний Recipe компонента, FeatureRecipe, який прив’язує вкладення на компоненті, і FeatureRecipe, який прив’язує вкладення рівня межі. Саме розділення забезпечує, що діагностика називає правильний документ: файли вкладення рендеряться під ідентичністю його компонента-хоста, тож колізію у FeatureRecipe вкладення повідомляють щодо цього FeatureRecipe, а не щодо хоста.

Кожне колізійне ім’я повідомляється окремо, тож документ, блоки якого зійшлися на двох іменах, повідомляє обидва. Знахідку розміщено в документі, який ви редагуєте для виправлення: в екземплярі компонента для Recipe і в самому FeatureRecipe для вкладення, причому знахідка також називає вкладення — компонент або межа можуть прив’язувати кілька.

Один блок, що виводить кілька файлів під одним іменем, — це не ця зупинка. Це один учасник, а не зустріч двох блоків, а дублікати ключів artifacts: усередині одного блоку відхиляються під час декодування документа.

Повідомлення, що виводиться:

filename collision across input kinds: two input-kind blocks produced a file under one output name (output name <filename>, produced by <origin1>, <origin2>) (колізія імен файлів між типами вхідних даних: два блоки типів вхідних даних створили файл під одним вихідним іменем)

Колізія у FeatureRecipe також містить вкладення:

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>) (колізія імен файлів між видами вхідних даних: два блоки видів вхідних даних створили файл під одним іменем виводу (ім’я виводу, створено, вкладення <instance>))

Як виправити: перейменуйте колізійний файл у тому виді вхідних даних, який ви контролюєте. Якщо колізія стосується імені файлу, перекладеного з Workload, і запису artifacts:, імена, перекладені з Workload, відповідають домовленостям перекладу провайдера (наприклад, <release-name>-deployment.yaml для helm, де ім’я релізу — {{ .context.rendered_name }}), — змініть ім’я файлу в artifacts: на таке, якого провайдер не синтезує.

An output-label key uses a reserved namespace (Ключ мітки виводу використовує зарезервований простір імен)

Recipe називає ключ мітки під aggrega.ai/ або app.kubernetes.io/ — в outputLabels:, блоці, що ставить літеральні мітки на відрендерений вивід, або в outputComponentLabels:, блоці, що називає ключі міток компонента, значення яких переносяться на вивід. Обидва префікси належать власному простору ключів походження платформи: це ключі, які ставить сама збірка, тож Recipe, що поставив би такий ключ, писав би в простір, який вказує, звідки походить ресурс. Резервування також гарантує, що набір міток Recipe не перетинається з набором походження, тож їх ніколи не доводиться узгоджувати під час злиття. Це правило перевіряється під час завантаження Recipe.

Резервування стосується лише голого кореня. Ключ, що лише містить зарезервований корінь глибше у власному просторі імен, — скажімо, component.aggrega.ai/hosting, — належить до іншого простору ключів, яким платформа не володіє, і його можна писати.

Повідомлення, що виводиться. Одна умова охоплює обидва блоки, тож її речення не може сказати, який із двох написано; порада після нього називає блок, цитуючи введений вами ключ і блок, у якому ви його ввели:

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) (обмеження output-labels для рецепта: ключ використовує зарезервований простір імен; ключ в outputLabels використовує зарезервований простір імен — “aggrega.ai/” і “app.kubernetes.io/” зарезервовано для даних про походження платформи)

Ключ, записаний у блоці перенесення, повідомляється під назвою правила цього блоку й називає його в пораді:

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) (обмеження output-labels для рецепта: ключ використовує зарезервований простір імен; ключ в outputComponentLabels використовує зарезервований простір імен — “aggrega.ai/” і “app.kubernetes.io/” зарезервовано для даних про походження платформи)

Ключі літерального блоку перевіряються в упорядкованому порядку, а ключі блоку перенесення — у порядку, в якому ви їх написали, тож Recipe, що порушує правило в кількох місцях, завжди першим повідомляє те саме.

Як виправити: перенесіть ключ у простір імен, яким ви володієте, — ваш власний домен або простір із підпрефіксом, як-от component.aggrega.ai/…, — або вилучіть його, якщо потрібне вам значення збірка вже ставить. Ключі походження, які має відрендерений ресурс, наведено в ../providers/well-known-annotations.md; щоб прочитати один із них, оголошення в Recipe не потрібне.

A promoted component label is also declared literally (Перенесену мітку компонента також оголошено літерально)

Recipe називає один ключ і в outputComponentLabels:, і в outputLabels:. Обидва блоки ставлять мітки на ту саму поверхню з різних джерел — перший переносить значення, яке має компонент, другий записує значення, введене автором Recipe, — тож ключ, названий в обох, отримав би два можливі значення без вказівки, яке перемагає. Це правило перевіряється під час завантаження Recipe, після правила зарезервованого простору імен вище, тож Recipe, що порушує обидва, першим повідомляє зарезервований простір імен: виправлення цієї помилки не залежить від вмісту іншого блоку.

Повідомлення, що виводиться:

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 (обмеження output-component-labels для рецепта: ключ також оголошено в outputLabels; ключ передається через outputComponentLabels і водночас оголошений буквально в outputLabels; залиште те джерело, з якого має надходити мітка, а інше видаліть)

Як виправити: вирішіть, звідки надходить значення мітки, і видаліть інше оголошення. Залиште запис outputComponentLabels:, коли значення має відповідати тому, що має компонент, щоб два компоненти, прив’язані до одного Recipe, ставили власні значення; залиште запис outputLabels:, коли значення належить самому Recipe і однакове, хоч де б Recipe було прив’язано.

Правила форми FeatureRecipe

FeatureRecipe складає свій вивід із тих самих видів вхідних даних, що й Recipe, і наведене нижче правило композиції обмежує його так само, як обмежує Recipe. Воно перевіряється під час завантаження FeatureRecipe і повідомляє у формі зупинки щодо форми Recipe — речення правила, потім документ із помилкою, назва правила й порада для цього випадку — з тегом CATALOG_ERROR.

Тут навмисно немає правила «щонайменше один вид вхідних даних», і в цьому відмінність від Recipe. FeatureRecipe, що оголошує лише провайдер і те, що він реалізує, — це правомірне суто з’єднувальне вкладення: воно нічого не рендерить, а його ефект — це з’єднання, яке несе реалізована ним Feature. Так само правомірний FeatureRecipe, що оголошує лише injectMapping:.

A FeatureRecipe’s valuesMapping requires source (valuesMapping у сутності FeatureRecipe потребує source)

Сутність FeatureRecipe оголошує valuesMapping, але не source. Відображення значень — це накладання, тож без чарту, модуля чи файлу, на який його накладають, відображеним значенням нікуди потрапити.

Повідомлення, що виводиться:

FeatureRecipe: valuesMapping requires source (FeatureRecipe <name>:<version>, rule values-mapping, at <path>). declare a source: pointer alongside valuesMapping (or remove the valuesMapping if no overlay is intended) (FeatureRecipe: valuesMapping потребує source (FeatureRecipe name:version, правило values-mapping, у path). оголосіть вказівник source: поряд із valuesMapping (або видаліть valuesMapping, якщо накладання не передбачено))

Як виправити: додайте вказівник source:, для якого було написано накладання, або видаліть valuesMapping і дайте прикріпленню виконати свою роботу інакше — через artifacts:, щоб видавати власні файли, через injectMapping:, щоб змінити форму того, що воно доставляє, або без жодного з них, як суто з’єднувальне прикріплення.

A pipeline declares one step id twice (Конвеєр оголошує один ідентифікатор кроку двічі)

Сутність Recipe або FeatureRecipe оголошує той самий id у двох кроках свого spec.pipeline. Крок публікує повернені ним виходи під своїм ідентифікатором, а пізніший крок того самого конвеєра читає їх як .steps.<id>.outputs, тож два кроки зі спільним ідентифікатором змусили б цей пізніший крок читати той із двох, що опублікував останнім, а не той, який ви мали на увазі.

Правило охоплює власний конвеєр одного документа. Сутність Recipe компонента і приєднані до нього сутності FeatureRecipes запускають свої конвеєри окремо, і кожен конвеєр починається без жодних виходів кроків, тож крок сутності Recipe і крок приєднаної сутності FeatureRecipe можуть мати той самий ідентифікатор.

Жодна схема не може виразити це правило — JSON Schema не має ключового слова для списку, записи якого унікальні за одним зі своїх полів, — тож редактор, що враховує схеми, приймає такий документ, а перевірка виконується під час читання документа, одразу після перевірки схеми. Про це повідомляє кожна поверхня, що читає сутність Recipe або FeatureRecipe: aggrega validate для файлу або для всього каталогу, збірка, що завантажує каталог, pull, що приймає отриману сутність, діагностика редактора та редагування документа, яке відхиляється, а не записується. Документ, який також не відповідає своїй схемі, спершу повідомляє результати перевірки схеми, а цю відмову — після того, як їх виправлено.

Кожне повторення є окремим результатом перевірки, розташованим на повтореному id, що називає крок, який оголосив цей ідентифікатор першим, із його рядком і стовпцем. Якщо ідентифікатор трапляється тричі, обидва пізніші кроки називають перший.

Повідомлення, що виводиться для сутності FeatureRecipe, другий крок якої повторює ідентифікатор першого кроку. Категорія і короткий код цієї умови, E0370, доходять до вас у заголовку у квадратних дужках:

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 (конвеєр оголошує один ідентифікатор кроку двічі; ідентифікатор кроку spec.pipeline[1].id уже оголошено в spec.pipeline[0].id. дайте кожному кроку конвеєра власний ідентифікатор і спрямуйте кожне посилання на крок, яке робить пізніший крок, на той крок, який воно має на увазі)

Як виправити: перейменуйте один із двох кроків, щоб кожен ідентифікатор було оголошено один раз. Потім перегляньте шаблони with: і when: кожного пізнішого кроку на наявність посилань .steps.<id> на ідентифікатор, який ви залишили, і спрямуйте кожне з них на крок, чиї виходи воно має на увазі, — саме перейменування робить виходи двох кроків доступними окремо.

A document declares an API version this compiler no longer reads (Документ оголошує версію API, яку цей компілятор більше не читає)

Рядок apiVersion документа оголошує aggrega.ai/v1alpha1. Кожен вид документа, що містить рядок apiVersion, оголошує aggrega.ai/v1beta1, єдину версію, яку читає цей компілятор, і жодного перетворення з попередньої версії не відбувається: документ відхиляється під час читання, перш ніж буде перевірено будь-що інше, оскільки кожна інша знахідка стосувалася б версії документа, яку компілятор не читає.

Про це повідомляє кожна поверхня, яка читає документ: aggrega validate, збірка, pull, що приймає отриману сутність, діагностика редактора та редагування документа. Документ, що оголошує версію, яку компілятор ніколи не читав, натомість відхиляється схемою свого виду з кодом E0215.

Повідомлення, що виводиться для сутності Component. Категорія та короткий код цієї умови, E0373, надходять до вас у заголовку у квадратних дужках:

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 (документ оголошує версію API, яку цей компілятор більше не читає (Component); 1:1: apiVersion: документ оголошує aggrega.ai/v1alpha1, а цей компілятор читає aggrega.ai/v1beta1. змініть рядок apiVersion на aggrega.ai/v1beta1)

Як виправити: змініть рядок apiVersion документа на apiVersion: aggrega.ai/v1beta1. Поля кожного виду між двома версіями не змінилися, тож цей рядок і є всією зміною.

A plugin declares a plugin ABI version this compiler no longer speaks (Плагін оголошує версію ABI плагінів, яку цей компілятор більше не підтримує)

Плагін оголошує ABI плагінів v1alpha1. Цей компілятор підтримує ABI плагінів v1beta1 і жодного іншого, тому плагін, зібраний під попередній ABI, відхиляється, а не запускається. Плагін зазначає свій ABI у двох місцях, і кожне з них відхиляється за цією однією умовою: звіт describe(), який повертає його гостьовий модуль під час завантаження, і поле spec.abiVersion його сутності Plugin, що відхиляється під час читання сутності, перш ніж буде перевірено будь-що інше. Плагін, що оголошує версію ABI, яку цей компілятор ніколи не підтримував, також відхиляється, перевіркою дескриптора (E0085) або схемою сутності Plugin (E0215).

Повідомлення, що виводиться для гостьового модуля під час завантаження. Категорія та короткий код цієї умови, E0374, надходять до вас у заголовку у квадратних дужках:

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 (плагін оголошує abi_version “v1alpha1”, а цей компілятор підтримує “v1beta1”; перезберіть плагін під поточний набір для розробки плагінів і опублікуйте його знову: плагін оголошує версію ABI плагінів, яку цей компілятор більше не підтримує)

Повідомлення, що виводиться для сутності 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 (плагін оголошує версію ABI плагінів, яку цей компілятор більше не підтримує (Plugin); spec.abiVersion: сутність Plugin оголошує abiVersion v1alpha1, а цей компілятор підтримує v1beta1. перезберіть плагін під поточний набір для розробки плагінів і опублікуйте його знову; тоді його сутність Plugin оголошуватиме abiVersion v1beta1)

Як виправити: перезберіть плагін під поточну версію його набору для розробки плагінів, яка записує v1beta1 у звіт describe() гостьового модуля, і опублікуйте його знову, щоб сутність, згенерована поруч із ним, також оголошувала abiVersion: v1beta1. Редагування лише рядка сутності недостатньо: сам гостьовий модуль і далі повідомляє попередній ABI та відхиляється під час завантаження.

An artifact carries a media type this compiler no longer reads (Артефакт має тип медіа, який цей компілятор більше не читає)

Артефакт, отриманий із реєстру, має тип медіа, під яким публікувала попередня версія, — application/vnd.aggrega.<kind>.v1alpha1 зі своїм суфіксом, у типі артефакту маніфесту, у його конфігурації або в одному з його шарів. Цей компілятор публікує та читає типи медіа v1beta1, тому артефакт відхиляється із зазначенням назви під час читання його маніфесту, перш ніж буде взято будь-що з його вмісту: однаково для сутності каталогу, плагіна та його виконуваного файлу чи пакета документації. Індексування реєстру пропускає такий артефакт, вказуючи причину. Тип медіа поза власним простором імен application/vnd.aggrega. продукту Aggrega ніколи не належить до цієї умови.

Повідомлення, що виводиться для сутності Component, опублікованої попередньою версією. Категорія та короткий код цієї умови, E0375, надходять до вас у заголовку у квадратних дужках:

"<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 (має тип медіа “application/vnd.aggrega.component.v1alpha1+yaml”, а цей компілятор читає “application/vnd.aggrega.component.v1beta1+yaml”; опублікуйте артефакт знову з поточною версією: oci: артефакт має тип медіа, який цей компілятор більше не читає)

Як виправити: опублікуйте артефакт знову з поточною версією aggrega, яка записує типи медіа v1beta1. Артефакт, який публікує хтось інший, має повторно опублікувати саме ця особа; доки цього не зроблено, його неможливо прочитати.

A file cannot be read, or its bytes do not parse (Файл неможливо прочитати, або його байти не розбираються)

Файл, який збірка мала прочитати, або документ Aggrega, який перевірка всього каталогу прочитала в каталогових директоріях, не дав нічого, що могла б використати поверхня, яка його назвала чи прочитала. Або його не вдалося прочитати з диска, або його байти було розібрано, і розбір завершився з помилкою. Далі на ньому нічого не виконується, бо немає вмісту для перевірки за схемою, немає компонентів для розміщення і немає шаблону для рендерингу.

Умова не називає формату, і це навмисно. Більшість файлів, які вона охоплює, читаються як YAML; тіла workload, values-mapping і артефактів сутності Recipe читаються як вихідний код шаблонів Go і взагалі не розбираються. Речення, що обіцяє YAML, відкривало б діагностику про файл шаблону твердженням про формат цього файлу. Яка з двох помилок сталася і для якого типу файлу, повідомляє частина після речення.

Документи, з яких починається збірка, — Aggregate, Release і Manifest — найчастіші суб’єкти, і зупинка виникає в кожній точці, де читається один із цих трьох. Діагностика називає, який документ читався і шлях, з якого його читали. Саме шлях відрізняє відсутній файл від некоректного: помилка читання наводить власну причину операційної системи, а помилка розбору — причину парсера YAML, яка містить рядок, на якому парсер зупинився.

Повідомлення, коли файл не вдалося прочитати:

file load failed: the file could not be read, or its bytes did not parse (Aggregate, at <path>, failed to read file: <underlying reason>) (не вдалося завантажити файл: файл неможливо прочитати, або його байти не розбираються (Aggregate, за шляхом <path>, не вдалося прочитати файл: <underlying reason>))

і коли його текст не розібрався:

file load failed: the file could not be read, or its bytes did not parse (Aggregate, at <path>, failed to unmarshal YAML: <underlying reason>) (не вдалося завантажити файл: файл неможливо прочитати, або його байти не розбираються (Aggregate, за шляхом <path>, не вдалося розібрати YAML: <underlying reason>))

Release і Manifest з’являються замість Aggregate, коли читається один із цих документів. Та сама умова охоплює й контракт параметрів, прочитаний з оголошеного блоку parameters: сутності Aggregate, який читається з власного тексту Aggregate до того, як у нього щось інтерполюється.

Сюди ж потрапляє parameters: { $import: … } сутності Release, що називає файл, до якого збірка не може дістатися, і з обох причин: шлях не називає файлу, який збірка може прочитати, або файл прочитано, але його байти не розбираються. Суб’єктом є Release, а частина повідомлення називає ключ, що вказував на файл:

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>) (не вдалося завантажити файл: файл не вдалося прочитати або його байти не розібрано (Release, за ключем .spec.parameters.$import, не вдалося прочитати файл)) 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>) (не вдалося завантажити файл: файл не вдалося прочитати або його байти не розібрано (Release, за ключем .spec.parameters.$import, не вдалося розібрати YAML))

Відносний шлях розв’язується від каталогу, що містить Release, який його записує, — Release, названий командою, або ланку його ланцюжка extends: — незалежно від того, звідки запущено команду, тож командний рядок і редактор читають той самий файл; абсолютний шлях називає власне місце. Переконайтеся, що checkout, на якому виконується збірка, містить файл у цьому місці: файл параметрів, наявний на вашій машині й виключений із системи контролю версій, відсутній під час запуску безперервної інтеграції, і саме так найчастіше трапляється ця помилка. Шлях, що веде за межі робочого простору — або, для Release, названого поза робочим простором, за межі власного каталогу цього Release, — взагалі не читається і повідомляється під «A reference to another file leads out of the directory it must stay inside (Посилання на інший файл виводить за межі каталогу, в якому має залишатися)» нижче.

Сюди ж потрапляє $import: схеми, що називає файл, до якого збірка не може дістатися, бо помилка та сама: директива коректна, а названий нею файл не дав документа. Суб’єктом тоді є сутність каталогу, а не одна з трьох, тож частина повідомлення називає поверхню схеми, для якої виконувалося розв’язання, — spec.schema, її опору, як-от spec.schema.values, або valueSchema сокета usesSchema, — а вказівник на джерело — це рядок, у якому записано директиву:

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> (не вдалося завантажити файл: файл неможливо прочитати, або його байти не розбираються. <surface>: читання імпортованої схеми <value>: <the operating system's reason>)

з resolve imported schema path замість read для рідшої невдачі взагалі встановити власний каталог сутності і з parse imported schema, коли файл прочитано, але його текст не є коректним YAML. Помилка в написаній вами директиві — сусідній ключ поруч із нею, значення, що не є шляхом, або імпортований вміст, що розібрався, але не є мапою, — це інша умова, і вона повідомляється під «A schema $import: cannot be applied (Неможливо застосувати $import: схеми)» нижче.

Сюди ж потрапляє імпорт valuesMapping:, workload: або artifacts.<name>: сутності Recipe чи FeatureRecipe з тієї самої причини і з тим самим виправленням: директива коректна, а названий нею файл не дав вмісту. Ці три тіла є вихідним кодом шаблонів Go, а не документами, тож збій можливий лише під час читання — на цьому етапі їх ніщо не розбирає. Сутність і ключ, що назвав шлях, передаються в частині повідомлення, а вказівник на джерело — це власний шлях імпортованого файлу:

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 (не вдалося завантажити файл: файл неможливо прочитати, або його байти не розбираються (імпорт файлу valuesMapping сутності Recipe <name>, <the operating system's reason>). якщо ви мали на увазі запис бібліотеки, а не файл, посиланню потрібен фрагмент — $import: без нього читається як шлях до файлу, а значення без лапок закінчується там, де пробіл перед # починає коментар, тож візьміть усе посилання в лапки) 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 (не вдалося завантажити файл: файл неможливо прочитати, або його байти не розбираються (імпорт файлу workload сутності Recipe <name>, <the operating system's reason>). якщо ви мали на увазі запис бібліотеки, а не файл, посиланню потрібен фрагмент — $import: без нього читається як шлях до файлу, а значення без лапок закінчується там, де пробіл перед # починає коментар, тож візьміть усе посилання в лапки) 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 (не вдалося завантажити файл: файл неможливо прочитати, або його байти не розбираються (імпорт файлу артефакту <key> сутності Recipe <name>, <the operating system's reason>). якщо ви мали на увазі запис бібліотеки, а не файл, посиланню потрібен фрагмент — $import: без нього читається як шлях до файлу, а значення без лапок закінчується там, де пробіл перед # починає коментар, тож візьміть усе посилання в лапки)

Саме фрагмент відрізняє посилання на бібліотеку від шляху: <Library>#/mappings/<entry> розв’язується за бібліотеками, а той самий текст без фрагмента — звичайний відносний шлях. Його легко непомітно втратити, бо звичайне значення YAML закінчується там, де пробіл перед # відкриває коментар, — тож $import: LibBeta:1.0.0 #/workloads/Web надходить до збірки як LibBeta:1.0.0, і збірка шукає файл із такою назвою поруч із Recipe. Щоб зберегти фрагмент, візьміть усе посилання в лапки.

Ті самі три ключі у FeatureRecipe повідомляють ту саму умову і читаються так само. Імпорт artifacts читається двічі за життя Release — коли aggrega pull фіксує pin його вмісту і знову під час рендерингу запису, — тож той самий відсутній файл повідомляє цю умову на тому з двох етапів, до якого ви дійдете першим. Помилка форми самої директиви, як-от сусідній ключ поруч із $import: або посилання oci:// з хостом, — це інша умова, і вона повідомляється під власним записом.

Перевірки всього каталогу aggrega lint і aggrega validate теж повідомляють тут — про документ у каталогових директоріях, який оголошує apiVersion Aggrega (рядок, що починається без відступу з apiVersion: і значення, що починається з aggrega.ai/) і який не вдається прочитати, розібрати або декодувати в оболонку, яку читає перевірка, як-от metadata, записаний списком. Шлях до нього не писав жоден автор: перевірка прочитала його, бо він лежить у каталоговій директорії. Кожна перевірка читає всі файли, перш ніж зупинитися, тож один запуск називає всі такі документи, нічого іншого не перевіряє й не виводить підсумку. YAML, який не оголошує apiVersion Aggrega, — зокрема шаблони Helm chart — пропускається. Заголовок підраховує документи й називає їхні файли, а під ним наведено кожен документ із причиною, яку дало читання чи сам парсер:

<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (документи в каталогових директоріях оголошують apiVersion Aggrega, але їх не вдалося завантажити, тож нічого не перевірено) 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>) (збій завантаження файлу: файл не вдалося прочитати або його байти не вдалося розібрати (документ каталогу, не вдалося розібрати YAML))

з failed to decode the envelope:, рядком і тим, що декодер там знайшов, — line 4 (metadata): a list is written where a map is expected для metadata, записаного списком, — для документа, який розбирається, але не декодується, і з failed to read file: та причиною від операційної системи для файлу, який не вдалося прочитати. Документ, який завантажується, але оголошує вид, якого не містить жоден каталог, називається тією самою зупинкою, враховується в тому самому заголовку і наводиться під власною умовою — див. «A catalog document declares a kind a catalog does not hold (Документ каталогу оголошує вид, якого каталог не містить)» нижче.

Як виправити: читайте шлях у повідомленні, а не назву документа — вони різняться щоразу, коли посилання розв’язалося в неочікуваному місці. Для помилки читання переконайтеся, що файл існує за цим шляхом, що шлях написано так, як його записує документ, що на нього посилається, і що збірка має право його читати; типовий випадок — файл, наявний локально і відсутній у checkout агента збірки. Для помилки розбору відкрийте файл на рядку, який назвав парсер, — значення без лапок, що містить двокрапку, табуляція для відступу і елемент списку з відступом під неправильним ключем — ось три причини більшості таких помилок.

A catalog document declares a kind a catalog does not hold (Документ каталогу оголошує вид, якого каталог не містить)

Документ у каталогах каталогу оголошує apiVersion Aggrega — рядок, що починається без відступу з apiVersion: і значення, яке починається з aggrega.ai/, — і kind, якого не містить жоден каталог: помилку в написанні, як-от Componnent, вид у неправильному регістрі, як-от component, або взагалі відсутній kind. Каталог розкладає кожен документ за видом, який той оголошує, тож такий документ не потрапляє до жодного каталогу: збірка, inspect і кожна інша команда, що завантажує каталог, пропускають його, а посилання на сутність, яку він мав оголосити, ні до чого не розв’язується.

Каталог містить документи Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate і Plugin. Три інші види правомірно лежать у його каталогах і тут ніколи не повідомляються: документи Manifest і Release, що зберігаються поряд із сутностями, і документ Workload у каталозі сутності Recipe або FeatureRecipe, яка його імпортує.

Про це повідомляють aggrega validate і aggrega lint для всього каталогу, а також lint в області сутності Release, який обходить ті самі каталоги. Кожна з цих команд читає всі файли, перш ніж зупинитися, тож один запуск називає кожен такий документ разом із будь-яким документом, який взагалі не вдається завантажити, під одним заголовком, що їх підраховує й називає їхні файли; нічого не перевіряється, і підсумок не виводиться. Кожен документ наводиться з видом, який він оголошує, а рядок завершується видами, які містить каталог:

<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (документи в каталогах каталогу оголошують apiVersion Aggrega, і їх не вдалося завантажити, тож нічого не перевірено) 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 (документ каталогу оголошує вид, якого каталог не містить. каталог містить документи Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate і Plugin і пропускає документи Workload, Manifest або Release; виправте вид або перемістіть файл за межі каталогів каталогу)

з no kind замість kind "<kind>" для документа, який не оголошує жодного виду.

Збірка не зупиняється на такому документі: вона пропускає його, як і кожне завантаження, а документ, до якого не доходить жодна сутність Release, ніколи не спричиняє збою збірки. Коли сутність Release таки доходить до цієї сутності, збірка зупиняється на посиланні, у межах «A reference names no entity the catalog holds (Посилання не вказує на жодну сутність, яку містить каталог)» нижче, а примітка під цим збоєм називає файл, якщо він оголошує ім’я, яке запитує посилання, — див. цей запис.

Як виправити: відкрийте файл, який називає повідомлення, і виправте його kind на вид, яким документ є насправді, — значення мають і написання, і регістр. Файлу, який узагалі не є сутністю каталогу, не місце в каталогах каталогу; перемістіть його або, якщо це документ іншого інструмента, дайте йому apiVersion, який не належить Aggrega.

A path names content outside the entity’s own directory (Шлях вказує на вміст поза власним каталогом сутності)

Вміст сутності розміщується у власному каталозі сутності, бо кожен файл, який несе публікація сутності, береться звідти. Шлях, що виходить за його межі, вказує на файл, який не переміщуватиметься разом із сутністю, тож цього файлу не буде в того, хто отримає сутність, а закріплення, записане для нього, засвідчує байти, яких отримувач не може здобути.

Тому кожен шлях, який сутність записує для вмісту, що вона несе, читається відносно каталогу з файлом сутності й має залишатися всередині нього. Це стосується source: сутностей Recipe і FeatureRecipe — простого шляху або url: структурованої форми, — файлу, який кожен запис valuesMapping:, workload: і artifacts: імпортує через $import:, і кожної схеми, яку імпортує сутність Component або Feature: цілком, для окремого стовпа чи для valueSchema і infraSchema сокета usesSchema. Каталог залишають три форми шляху: шлях, що піднімається вище за нього; абсолютний шлях, який називає місце на машині, де його записано; і шлях, записаний усередині каталогу, який символьне посилання на шляху виводить назовні, — каталог уздовж шляху, як і файл у його кінці, що є посиланням за межі каталогу сутності. Шлях, що піднімається й повертається всередину, — ./charts/../values.tmpl, — є звичайним шляхом усередині каталогу, як і шлях через посилання, що веде в інше місце всередині нього. Підйом, що повертається в каталог за його власною назвою, — ../1.0.0/values.tmpl, записаний у каталозі з назвою 1.0.0, — відхиляється, бо назва каталогу не входить до того, що переміщується: опубліковану сутність читають із каталогу, назву якому дає кеш споживача, і там ця назва нічого не знаходить. Шлях через посилання назовні відхиляється, бо інакше публікація несла б байти, на які вказує посилання, звідки б вони не походили, під назвою всередині сутності.

Це відхиляється всюди, де читається сутність. aggrega validate для всього каталогу, aggrega validate для власного файлу сутності, aggrega pull і aggrega build відхиляють це під час читання файлу сутності, як і aggrega pin для Recipe або FeatureRecipe та aggrega push для будь-якого з чотирьох видів — ще до того, як щось буде завантажено, записано чи опубліковано. source:, записаний як шаблон, нічого не називає, доки збірка його не обчислить, тож шаблон, що дає шлях поза каталогом, відхиляє збірка в момент, коли значення з’являється.

Інакше з Release, і так само з посиланням на сутність. Release вказує на інші сутності — свій Aggregate, свій Manifest, Release, який він розширює, — і ніколи не публікується, тож ніщо з того, що він читає, нікуди не переміщується: ці шляхи, а також файл, який імпортує parameters: сутності Release, читаються так, як записані. Поле type сутності Aggregate називає іншу сутність за її ідентичністю, а не вміст, який несе Aggregate, і також розв’язується за власними правилами: через каталогові директорії, кеш і реєстр, але ніколи як шлях до файлу.

Повідомлення, яке видається, називає шлях так, як його записано:

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 (шлях вказує на вміст поза власним каталогом сутності. Виправлення: перемістіть файл у каталог із сутністю або в підкаталог і вкажіть його шляхом відносно цього каталогу. Вміст сутності розміщується у її власному каталозі, бо кожен файл, який несе її публікація, береться звідти; шлях, що виходить за його межі, вказує на файл, який не переміщуватиметься разом із сутністю)

а для шляху, який посилання виводить за межі каталогу, — називаючи посилання й місце, куди воно веде:

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 (шлях вказує на вміст поза власним каталогом сутності, посилання веде назовні. Виправлення: замініть посилання копією того, на що воно веде, розміщеною в каталозі із сутністю. Вміст сутності розміщується у її власному каталозі, бо кожен файл, який несе її публікація, береться звідти; посилання назовні несло б байти, на які воно вказує, під назвою всередині сутності)

Поле, з якого прочитано шлях, названо в рядку над повідомленням: resolve Recipe source …, resolve Recipe artifact "<key>" $import target …, spec.schema.values: imported schema … або, для шаблонного джерела, node "<name>" source.

Як виправити: перемістіть файл у каталог сутності або в підкаталог і запишіть його шлях відносно цього каталогу. Якщо шлях виводить назовні посилання, замініть посилання копією того, на що воно веде, усередині каталогу сутності. Chart, спільний для кількох Recipes, копіюється в каталог кожної Recipe, бо кожна публікується окремо; схема, спільна для кількох Components, належить до SchemaLibrary, на яку кожен Component потім посилається за ідентичністю, а тіло відображення, workload чи артефакту, спільне для кількох Recipes, належить до відповідного виду бібліотеки.

source: сутності Recipe називає тип, який ніщо не вміє отримати

source: сутності Recipe вказує, на що саме він посилається — чарт, модуль, проєкт compose, — і кожен тип отримує адаптер джерела, який обслуговує цей тип. Ця умова повідомляє про тип, якого не обслуговує жоден адаптер джерела, тож ніщо з того, що містить ця програма, не може отримати джерело. На source: сутності FeatureRecipe поширюється те саме правило.

Відмова відбувається під час читання документа, до того як щось отримано: її дає перевірка самої сутності Recipe, а також кожна сутність Release, яка до неї доходить. Нічого не було зроблено, бо ніщо не могло цього зробити, — саме це відрізняє його від отримання, яке виконалося й завершилося збоєм.

Повідомлення, що виводиться, називає документ, тип у тому вигляді, як його записано, і типи, що обслуговуються:

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 (жоден адаптер джерела не обслуговує цей тип джерела (Recipe, правило source-kind). джерело називає цей тип; назвіть тип, який обслуговує адаптер джерела, або запишіть джерело як єдиний URI, форма якого визначає його тип)

Як виправити: замініть тип у source: на такий, який обслуговує інструментарій, — помилка в написанні й тип, для якого справді немає адаптера, дають однакове повідомлення, а повідомлення цитує тип так, як ви його написали, поруч із типами, що обслуговуються, тож спершу звірте написання з цим списком, який також описано на сторінці Recipe. Якщо тип написано так, як ви задумали, цей тип не може отримати ця збірка, і жодна зміна в Recipe цього не змінить; натомість спрямуйте source: на форму, яка обслуговується, або запишіть його як єдиний URI, форма якого визначає його тип.

No source adapter is registered in this program for a source kind (У цій програмі не зареєстровано адаптера джерела для типу джерела)

Джерело отримує адаптер, зареєстрований для його типу. Ця умова повідомляє про отримання, спрямоване на тип, для якого не зареєстровано жодного адаптера. Записаний автором тип, якого не обслуговує жоден адаптер, відхиляється під час читання його сутності Recipe (див. «A Recipe’s source: names a kind nothing knows how to acquire (Джерело сутності Recipe називає тип, який ніщо не вміє отримати)» вище), тож ніщо з написаного автором сюди не доходить: умова повідомляє про програму, зібрану без адаптера для типу, який вона обслуговує, або про програму на основі Go-пакетів Aggrega, що спрямовує запит на тип, який вона зібрала сама.

Повідомлення, що виводиться, називає тип:

kind "<kind>": no source adapter is registered in this program for the source kind (у цій програмі не зареєстровано адаптера джерела для цього типу джерела)

Як виправити: ніщо у ваших файлах сутностей цього не спричиняє. Повідомте про це тому, хто зібрав двійковий файл, який ви запускаєте.

A source URL carries a credential (URL джерела містить облікові дані)

url джерела записується так, як ви його написали, — у lock-файл Release, в entity.lock поруч із Recipe і в кеш джерел, — а сама сутність Recipe є файлом, який ви фіксуєте в репозиторії й можете опублікувати. Тож облікові дані, записані в URL, потрапили б усюди, куди потрапляє URL. Ця умова повідомляє про source: сутності Recipe, у якому url містить користувача перед хостом: https://user:token@host/… або токен, записаний окремо як https://token@host/…, адже сервіс, доступний через HTTP, зазвичай приймає токен на місці користувача. Для http і https враховується будь-який записаний там користувач; для іншої схеми — лише пароль, бо записаний там окремо користувач називає обліковий запис: ssh://git@github.com/… приймається, а ключ надає SSH-агент. На source: сутності FeatureRecipe поширюється те саме правило.

Відмова відбувається під час читання документа, до того як щось отримано: її дає перевірка самої сутності Recipe, а також кожна сутність Release, яка до неї доходить, — під час валідації, pull, pin або збірки. Повідомлення називає хост і ніколи — облікові дані. Перевірка читає лише частину URL, записану перед хостом, і нічого більше, тож токен у рядку запиту чи шляху не виявляється — і записується як є, як і решта URL.

Повідомлення, що виводиться для http або https, називає документ, ключ і хост, а потім місце, де мають бути облікові дані:

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 джерела містить облікові дані (Recipe, правило source-url). spec.source.url називає користувача або пароль для хоста; видаліть їх з URL і натомість запишіть облікові дані у файл netrc як запис machine, login, password (файл, який вказує NETRC, інакше .netrc у домашній директорії або _netrc у %USERPROFILE% у Windows))

і для іншої схеми, де рішення — видалити пароль:

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 джерела містить облікові дані (Recipe, правило source-url). spec.source.url називає пароль для хоста; видаліть його з URL, який записується в lock-файл і кеш так, як написаний)

Як виправити: видаліть користувача й пароль з url, залишивши URL, що називає хост. Для джерела, яке отримується через http або https, помістіть облікові дані в запис machine для цього хоста у вашому файлі netrc, який читається під час кожного отримання класичного репозиторію Helm chart, фрагмента compose або Git-репозиторію через HTTP чи HTTPS; який файл і який запис, описано в розділі Автентифікація. Для Git-репозиторію через SSH ключ надає SSH-агент, і користувач може залишитися. Якщо сутність Recipe вже було зафіксовано чи опубліковано з обліковими даними, вони лишилися в цій історії: змініть їх також на сервері.

A {{ .parameters.* }} reference cannot be interpolated (Посилання {{ .parameters.* }} неможливо інтерполювати)

Текст сутності Aggregate обчислюється як шаблон до того, як його прочитано як документ, щоб посилання {{ .parameters.<key> }} замінювалося значенням, яке для нього надала сутність Release. Ця зупинка спрацьовує, коли це обчислення неможливо завершити: текст не розбирається як шаблон або розбирається, але завершується збоєм під час виконання.

Інтерполяція відбувається до того, як Aggregate розбирається як YAML, тому помилка тут повідомляється щодо Aggregate загалом, а не щодо ключа всередині нього — на цьому етапі документ ще не має ключів. Тому ж посилання можна залишати без лапок: підстановка відбувається в сирих байтах, а власне правило лапок YAML потім визначає тип значення, тож посилання без лапок дає природний тип значення, а взяте в лапки — рядок.

Посилання, що називає ключ, якого Release не надав, — це не ця зупинка. Відсутній ключ тут розв’язується в порожнє значення і виявляється разом зі своїм типом і контрактом перевірками параметрів, описаними вище в розділі «Parameter type mismatch / contract violation (Невідповідність типу параметра / порушення контракту)». Ця зупинка повідомляє про текст, який шаблонний рушій узагалі не зміг обробити: незакриту {{, неправильно написану назву функції, конвеєр, етапи якого не узгоджуються між собою. Читання параметра через index — {{ index .parameters "db_size" }} — коли Release не надав такого параметра, є збоєм під час виконання, і цю помилку несе саме ця зупинка, називаючи ключ: index зупиняється на ключі, якого немає в мапі, на кожній шаблонній поверхні, як описано нижче в розділі «A template indexes a map with a key the map does not hold (Шаблон індексує мапу ключем, якого в мапі немає)».

Текст, який узагалі не розбирається, відхиляється із зазначенням власного шляху Aggregate, бо цей файл уже є в наявності, перш ніж щось його прочитає. Модуль, який імпортує композиція, обчислюється так само на рівень глибше, де його текст читається з каталогу, а не передається збірці. Зупинка в обох випадках — та сама умова з тим самим кодом; для модуля вона також називає імпорт, за яким ішла, і файл, з якого прочитано текст модуля, а повідомлення, яке вона несе, називає лише вид — тож позиція, яку дає це повідомлення, є позицією у власному тексті модуля, а не в Aggregate, з якого ви почали.

Повідомлення, що виводяться: для шаблону, який не розбирається, для тієї самої помилки в модулі, який імпортує композиція, і для шаблону, що завершується збоєм під час виконання:

invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate <path>, “template parse error: <underlying reason>”) (недійсне посилання на параметр: перевірте, що вираз {{ .parameters.* }} називає оголошений параметр і розбирається як шаблон Go) invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template parse error: <underlying reason>) (недійсне посилання на параметр: перевірте, що вираз {{ .parameters.* }} називає оголошений параметр і розбирається як шаблон Go) invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template execution error: <underlying reason>) (недійсне посилання на параметр: перевірте, що вираз {{ .parameters.* }} називає оголошений параметр і розбирається як шаблон Go)

Текст Aggregate має один корінь — .parameters, тож посилання через будь-який інший — {{ .values.app_token }} або {{ $.values.app_token }} — нічого не читає й завершується збоєм під час виконання. Тоді причина починається з назви прочитаного посилання:

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>) (недійсне посилання на параметр: перевірте, що вираз parameters називає оголошений параметр і розбирається як шаблон Go (Aggregate; шаблон читає це посилання, а текст Aggregate не визначає коренів, окрім .parameters; помилка виконання шаблону))

Як виправити: відкрийте Aggregate і прочитайте першопричину, яка називає позицію в тексті та конструкцію, що дала збій. Переконайтеся, що кожне {{ має своє }}, що викликана вами функція є серед тих, які пропонує ця поверхня, — інтерполяція параметрів пропонує функції Sprig і нічого більше, тож помічник optional тут недоступний — і що етапи конвеєра приймають те, що видає попередній етап. Якщо причина називає ключ, якого не знайшов index, читайте параметр, який може бути не заданий, через крапку ({{ .parameters.db_size }}) або через get чи hasKey зі Sprig. Якщо вона називає посилання через інший корінь, оголосіть значення як параметр Aggregate і читайте його як {{ .parameters.<key> }}. Якщо вона називає щось, що ви ніколи не мали на увазі як шаблон, — undefined variable "$json" з виразу n8n або функцію, названу на честь вузла Flowise, — текст містить власні подвійні фігурні дужки, зокрема в коментарі: запишіть кожне {{ у ньому як {{"{{"}}, як описано в розділі Текст, що містить власні подвійні фігурні дужки.

The Release directory declares one Aggregate or Manifest twice (Каталог Release оголошує один Aggregate або Manifest двічі)

Сутність Release, чиє посилання aggregate: або manifest: є голою ідентичністю, розв’язується спершу скануванням власного каталогу Release, і це сканування знайшло два Aggregates — або два Manifests — з однаковим metadata.name. Посилання з голою ідентичністю називає сутність за цим ім’ям, тож ім’я, заявлене двічі, — це ім’я, за яке каталог не може відповісти.

Сканування відхиляє каталог загалом, а не лише ім’я, про яке запитало посилання. Воно читає кожен Aggregate і кожен Manifest поруч із Release, тож пара, що конфліктує, але жодне посилання її не називає, також зупиняє збірку: каталог неоднозначний незалежно від того, чи саме ця Release збиралася прочитати ту сутність. Посилання, записане як шлях (./aggregate.yaml, ../shared/manifest.yaml), адресує файл, а не сутність, і розв’язується без сканування, тож Release, у якої aggregate: і manifest: обидва є шляхами, ніколи його не запускає.

Це відповідник у межах одного каталогу для відмови каталогу сутностей через дубльовану ідентичність, і про них повідомляється окремо, щоб повідомлення називало каталог, у якому ви перебуваєте, а не рівень каталогу сутностей, про який ви, можливо, не думали.

Повідомлення, що виводиться:

duplicate Aggregate/Manifest identity (metadata.name) in the Release directory: Aggregate "<name>" declared more than once in <release-directory> (дубльована ідентичність Aggregate/Manifest (metadata.name) у каталозі Release: Aggregate з цим іменем оголошено більше одного разу в цьому каталозі)

з Manifest замість Aggregate, коли конфліктують два Manifests.

Як виправити: надайте одній із двох сутностей інше metadata.name або перемістіть її з каталогу Release. Дві Releases, які справді розгортають різні Aggregates з однаковим ім’ям, мають бути у власних каталогах; копіювання Release в сусідній файл без перейменування того, що вона містить, — звичайна причина цієї ситуації.

A Release’s aggregate: or manifest: reference resolves to nothing (Посилання aggregate: або manifest: у сутності Release ні на що не розв’язується)

Release називає Aggregate або Manifest за голою ідентичністю, і жодної сутності з таким ім’ям не знайдено на жодній з поверхонь, де шукається гола ідентичність: у власному каталозі Release, у каталозі сутностей і в реєстрі.

Повідомлення, що виводиться, коли ніде нічого не збіглося:

aggregate/manifest reference unresolvable: no Aggregate named "<reference>" in the Release directory, catalog, or registry (посилання aggregate/manifest неможливо розв’язати: Aggregate з таким іменем немає ні в каталозі Release, ні в каталозі сутностей, ні в реєстрі)

Файл у каталозі Release, який не вдалося проіндексувати, змінює звіт, бо змінює те, що можна чесно стверджувати. Такий файл міг бути шуканою сутністю, тож повідомлення так і каже, а не стверджує відсутність, яку не може встановити, і містить збій розбору, що завадив його прочитати:

aggregate/manifest reference unresolvable: Aggregate "<reference>" not found; unparseable file <path> could not be indexed and may be it: <parse failure> (посилання aggregate/manifest неможливо розв’язати: Aggregate не знайдено; файл, який не вдалося розібрати, не вдалося проіндексувати, і, можливо, це саме він)

і коли файл, що не розбирається, — саме той, який посилання називає прямо:

aggregate/manifest reference unresolvable: needed Aggregate "<reference>" is the unparseable file <path>: <parse failure> (посилання aggregate/manifest неможливо розв’язати: потрібний Aggregate — це файл, який не вдалося розібрати)

Як виправити: якщо сутність справді відсутня, виправте написання посилання — ідентичністю є metadata.name сутності, а не ім’я її файлу — або додайте сутність до каталогу Release чи до каталогу сутностей, який читає збірка. Якщо повідомлення називає файл, що не розбирається, спершу виправте цей файл: його збій розбору наведено в повідомленні, і виправлення часто розв’язує посилання тим самим редагуванням. Посилання ./ або ../ є шляхом, а не ідентичністю, і розв’язується як шлях, тож крапка на початку змінює, яку з двох помилок ви шукаєте.

A component is placed in more than one boundary (Компонент розміщено в більш ніж одній межі)

Дерево меж сутності Release розміщує один компонент у двох різних межах. Ці два розміщення не об’єднуються і не ранжуються, і це неможливо: межа компонента визначає, куди записується його вивід, у який підкаталог він потрапляє, до якої хвилі синхронізації приєднується та які анотації меж і інфраструктуру меж успадковує, — тоді як його поверхню uses: для кожного ребра читає окремий обхід. Компонент, названий двічі, брав би розташування виводу з одного розміщення, а конфігурацію ребер — з іншого.

Межа розміщує компоненти трьома способами, і враховуються всі три. Назвати компонент безпосередньо в components: за ідентифікатором, який він має після завершення композиції, — це розміщення. Назвати його у власному components: запису маршрутизації за локальною назвою, яку він має в цьому підмодулі, — теж розміщення. А маршрутизація цілого підмодуля через aggregates: розміщує кожен компонент, що міститься в модулі. Тож ця зупинка охоплює також один підмодуль, спрямований у дві межі, модуль, спрямований в одну межу, тоді як вкладений у нього модуль спрямовано в іншу, і компонент, названий в одній межі, тоді як модуль, що його містить, спрямовано в іншу.

Спрямувати модуль у межу й водночас назвати один з його компонентів у тій самій межі — не конфлікт: обидва розміщення згодні щодо місця компонента, і збірка проходить. Один ідентифікатор, записаний двічі в одній межі, — конфлікт навіть тут: запис у components: межі та запис того самого компонента в записі маршрутизації межі — це два записи з конфігурацією для одного компонента, між якими нема чого обирати.

Повідомляється про кожне хибне розміщення. Release, що розміщує кілька компонентів двічі, зупиняється з однією такою помилкою на кожен хибний запис в одній збірці, кожна — на ключі запису, до якого вона має претензію; тож кілька таких помилок разом — це одна збірка, що називає все знайдене, а не одна помилка, виписана кілька разів.

Розміщення, яке повідомлення називає вже чинним, не завжди записане у файлі першим. Власні записи components: межі читаються раніше за компоненти, названі її записами маршрутизації, і раніше за підмодулі, які вона спрямовує, а межа читається раніше за вкладені в неї межі; межі, записані поруч, читаються в порядку появи. Якщо конфліктує більше одного попереднього розміщення, називається перше прочитане. Обидва місця називаються незалежно від порядку, і жодне не ставиться вище за інше.

Повідомлення, що виводиться. Речення формулює правило; далі називаються хибний запис, межа кожного з двох розміщень, блок, у якому записано кожне з них, і файл, що містить обидва. Коли запис у components: однієї межі зустрічає попередній запис іншої межі:

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>") (компонент оголошено в більш ніж одній межі: оголошуйте кожен компонент рівно в одній межі)

Два звороти, що називають межі, сформульовано відповідно до блоку, у якому записано кожен запис. Хибний запис отримує один із:

  • named in the components block of boundary "<boundary>" — власна мапа components: межі;
  • named inside a routing entry in boundary "<boundary>" — мапа components: запису маршрутизації в aggregates: цієї межі;
  • routed as a sub-module into boundary "<boundary>" — сам запис маршрутизації.

Попереднє розміщення, продовжуючи те саме речення, отримує один із:

  • 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>".

Два звороти обираються незалежно, тож може з’явитися будь-яка їх пара, а that earlier entry naming містить те, на що вказувало попереднє розміщення: ідентифікатор компонента або префікс підмодуля, якщо його розмістив спрямований підмодуль.

Якщо хибний запис сам є записом маршрутизації, він вказує на підмодуль, а не на окремий компонент, і повідомлення так і каже, а не подає префікс модуля як назву компонента, — тут він зустрічає попередній підмодуль, спрямований в іншу межу:

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>") (компонент оголошено в більш ніж одній межі: оголошуйте кожен компонент рівно в одній межі)

Як виправити: видаліть те з двох розміщень, яке ви не мали на увазі. Повідомлення називає обидва, тож вибір за вами, а не за компілятором. Якщо пряме оголошення і спрямований модуль розходяться, вирішіть, чи належить компонент своєму модулю, чи окремо: маршрутизація модуля розміщує його разом з усім іншим у модулі, а пряме називання відокремлює його. Якщо два записи маршрутизації претендують на один модуль, приберіть небажану маршрутизацію: спрямування модуля в межу розміщує там кожен його компонент, тож два такі записи претендують на той самий набір компонентів.

A Manifest annotation binding claims the reserved aggrega.ai/ prefix (Прив’язка анотації в Manifest претендує на зарезервований префікс aggrega.ai/)

Manifest оголошує прив’язку анотації з ключем, що починається з голого префікса aggrega.ai/. У цьому префіксі збірка ставить ключі, які виводить сама, тож прив’язка з ключем у ньому помістила б вашу маршрутизацію і власний вивід платформи в один простір ключів, де вони змагалися б за ті самі назви.

Це зупинка, і попередженням вона бути не могла. Саме резервування робить цей простір ключів простором платформи; прийняти прив’язку й згадати про неї згодом означало б залишити колізію у збірці.

Правило стосується простору ключів, на який претендує написана автором прив’язка, тож ключ, для якого поданий Manifest не оголошує прив’язки, пропускається, а не повідомляється: немає прив’язки, яка б щось порушувала.

Повідомлення, що виводиться. Хибний ключ іде першим, бо речення саме про нього, а кожне значення після нього вводиться назвою того, чим воно є:

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>/") (прив’язка анотації маніфесту використовує зарезервований префікс)

Як виправити: перейменуйте ключ прив’язки в простір імен, який ви контролюєте. Ключ із підпрефіксом — підтримувана форма, і він не зарезервований: feature.aggrega.ai/… для скорочення стандартної бібліотеки або ваш власний домен — acme.aggrega.ai/…, compliance.example.com/… — для корпоративного. Перейменування ключа змінює те, що автор пише на компоненті, щоб активувати прив’язку, тож оновіть анотації, які його використовують, у тій самій правці. Власні ключі платформи з голим префіксом перелічено в ../providers/well-known-annotations.md.

Дві прив’язки анотацій Manifest конкурують за один слот маршрутизації

Дві прив’язки анотацій в одному Manifest маршрутизують до тієї самої сутності Feature, через той самий стовп, за тим самим шляхом. Завдання прив’язки — вказати, куди потрапляє значення анотації, і дві прив’язки, що називають одне призначення, залишають значенню два маршрути без жодної підстави обрати між ними під час розгортання.

Лише одна прив’язка може оголошувати дану пару шлях-стовп для кожної цільової сутності Feature. Дві прив’язки, що спрямовані на ту саму сутність Feature за різними шляхами, — звичайне авторство і збираються; так само як і дві прив’язки, що маршрутизують той самий шлях до двох різних сутностей Features.

Прив’язки обходяться в тому порядку, в якому їх оголошує Manifest, тож прив’язка, яку повідомлення називає першою, завжди є ранішою у вашому документі.

Повідомлення, що виводиться:

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) (прив’язки анотацій маніфесту конфліктують на тій самій парі шлях+стовп Feature: Manifest, у <path>, прив’язки анотацій «<first-key>» і «<second-key>» обидві спрямовані на Feature «<feature-uri>» зі шляхом «<path>», що маршрутизується до стовпа «<pillar>»; лише одна прив’язка може оголошувати певну пару (шлях, стовп) для кожної Feature)

Як виправити: вирішіть, якій прив’язці належить призначення, і видаліть шлях зі списку maps.infra або maps.values іншої, або зовсім приберіть другу прив’язку. Якщо дві прив’язки існують тому, що ви хотіли, щоб два ключі анотацій досягали одного поля Feature, залиште одну прив’язку і дозвольте обом ключам анотацій маршрутизуватися через неї; якщо вони існують тому, що два різні значення мали потрапити у два місця, виправте той шлях, який було записано помилково.

Release дійшов до розв’язання, не пройшовши шлях завантаження

Сутність Release прибула на розв’язання, маючи водночас непорожню поверхню components: верхнього рівня і синтезовану межу default. Таке поєднання не може утворити Release, завантажений звичайно: шлях завантаження згортає блок components: верхнього рівня в межу за замовчуванням і очищує його, а документ, що прямо написав обидва, відхиляється його схемою, перш ніж дійде так далеко.

Тож ця зупинка не повідомляє про щось, що написали ви. Вона повідомляє, що щось дійшло до розв’язання в обхід шляху завантаження — найчастіше Release, створений у пам’яті програмою, що вбудовує компілятор, а не прочитаний з файлу, — і зупиняється на цьому, замість дозволити збиранню продовжитися на документі, дві поверхні компонентів якого не узгоджуються. Читання їх у будь-якому порядку дало б вивід, що мовчки пропускає або дублює компоненти, а обхід меж і обхід по ребрах навіть не погодилися б між собою, які саме.

Повідомлення, що виводиться:

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 (реліз дійшов до розв’язання ненормалізованим (непорожні кореневі компоненти поряд із синтезованою межею за замовчуванням): створюйте релізи через ядро нормалізації (types.NormalizeRelease через шлях завантаження), а не вручну зібраним літералом)

Як виправити: нічого, якщо ви пишете YAML — потрапляння на цю зупинку з aggrega build, aggrega validate або редактора означає, що в компіляторі є дефект, про який варто повідомити, а Release, який ви збирали, не винен. Якщо ви вбудовуєте компілятор і будуєте значення Release у власному коді, створюйте його через шлях завантаження, а не збирайте структуру безпосередньо, щоб виконалася нормалізація, яка згортає кореневі компоненти в межу за замовчуванням.

Посилання на бібліотеку розгортається саме в себе

Ланцюг міждокументних посилань повертається до документа, якого вже досяг, тож його розгортання ніколи б не завершилося. До того самого стану ведуть дві поверхні авторства, і обидві є ланцюгами між бібліотечними сутностями, а не чимось усередині одного файлу: $ref: зі стовпа схеми в запис SchemaLibrary, що посиланнями повертається назад, і $import: у запис MappingLibrary або WorkloadLibrary, що робить те саме.

Ланцюг порівнюється за канонічним ключем — ідентичністю бібліотеки та назвою запису, без будь-якого хоста реєстру і написання версії, — тож цикл не може уникнути перевірки, назвавши той самий запис двома різними способами на своєму шляху. Посилання, що розгортається і завершується, є прийнятним, скільки б разів воно не з’являлося і хоч яким глибоким був ланцюг; сама лише глибина ніколи не спричиняє цієї зупинки, а повторне використання одного бібліотечного запису з багатьох місць — саме той шаблон, заради якого існують бібліотеки.

Повідомлення, що виводиться, для ланцюга $import:, яке називає весь цикл у порядку обходу, щоб ви бачили, який крок його замикає:

circular reference expansion: <Library>#/mappings/<entry> -> <Library>#/mappings/<entry> -> <Library>#/mappings/<entry> (циклічне розгортання посилань)

Про ланцюг $ref: натомість повідомляє компілятор компактної форми, який обрамлює його документом і ключовим словом, яке він читав:

compactform at <consumer-file> (keyword "$ref"): circular cross-document $ref expansion: <Library>#/schemas/<entry> -> <Library>#/schemas/<entry> -> <Library>#/schemas/<entry> (compactform у <consumer-file>, ключове слово «$ref»: циклічне міждокументне розгортання $ref: <Library>#/schemas/<entry> -> …)

Як виправити: прочитайте ланцюг у повідомленні та розірвіть його на тому кроці, який не був задуманий. Цикл зазвичай означає, що два бібліотечні записи було написано так, що кожен розширює інший; винесіть спільну частину в третій запис, на який посилаються обидва, або вбудуйте її в один із них. Останній показаний крок — той, що замкнув цикл, але він не обов’язково хибний — весь ланцюг виводиться саме тому, що рішення, яку ланку розірвати, за вами.

Той самий стан також лежить в основі відмови через рекурсію якорів, описаної вище в розділі «YAML anchor aliased inside its own content». Та — цикл усередині власного тексту одного документа; ця — цикл між документами. Ланцюг у повідомленні з першого погляду їх розрізняє: цикл між документами називає бібліотечні записи, а цикл усередині документа — якір.

Оголошену схему неможливо розв’язати

Схема дійшла до того моменту, коли нею мають щось валідувати, і її взагалі не вдалося зібрати в схему. Найпоширеніша причина — $ref:, що не називає нічого розв’язуваного; до тієї самої зупинки призводить схема, яка не відповідає метасхемі JSON Schema, а також гілка then: або else: під умовним ключовим словом, яку неможливо розв’язати саму по собі.

Відмова відбувається до того, як щось валідується за схемою, і саме в цьому порядку суть. Пропуск нечитабельної схеми залишив би все, що вона охоплює, без валідації, тоді як збирання повідомляло б про успіх, — перевірка, що перестала виконуватися, і ніщо не повідомляє, що вона зупинилася.

Повідомлення, що виводиться, називає позицію всередині схеми, ключове слово, яке не вдалося розв’язати, і те, що повідомило розв’язання:

validator/jsonschema: schema resolution failed (at <path-inside-the-schema>, keyword "<keyword>", <what resolution reported>) (validator/jsonschema: не вдалося розв’язати схему: у <path-inside-the-schema>, ключове слово «<keyword>», <what resolution reported>)

Якщо збій стався в корені схеми, а не на ключовому слові всередині неї, позиція та ключове слово опускаються, і речення містить лише повідомлену причину.

Як виправити: відкрийте схему в позиції, яку називає повідомлення. Зазвичай винуватцем є $ref:: переконайтеся, що ціль існує, що внутрішньодокументне посилання точно записує свій шлях #/$defs/…, і що міждокументне посилання називає запис SchemaLibrary, який справді містить замикання залежностей збирання. Якщо повідомлення називає гілку then: або else:, ця гілка є самостійною схемою і має бути розв’язуваною сама по собі.

An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (Предикат x-aggrega-when: або x-aggrega-validate: неможливо обчислити)

Схема оголошує одне з двох ключових слів розширення, значенням яких є шаблон, і цей шаблон не вдалося використати: він не є рядком, не розбирається як шаблон, завершився помилкою під час виконання або відрендерив щось інше, ніж true чи false.

x-aggrega-when: визначає, чи застосовується умовна гілка схеми; x-aggrega-validate: визначає, чи задовольняє значення правило, яке власні ключові слова схеми виразити не можуть. Обидва читаються як вердикти, тому результат, що не є вердиктом, відхиляється, а не інтерпретується: предикат, який рендерить порожній рядок, було б прочитано як false, і він непомітно скасував би правило, для забезпечення якого його написано.

Повідомлення, що виводиться:

validator/jsonschema: x-aggrega extension evaluation failed (at <path-inside-the-schema>, keyword "x-aggrega-validate", <what evaluation reported>) (validator/jsonschema: не вдалося обчислити розширення x-aggrega (у <path-inside-the-schema>, ключове слово “x-aggrega-validate”, <what evaluation reported>))

з "x-aggrega-when" на місці ключового слова, якщо помилковим є предикат умовної конструкції, а повідомлена причина називає помилку шаблону — позицію розбору, відсутню функцію або небулеве значення, яке створив шаблон.

Як виправити: відкрийте схему в позиції, яку називає повідомлення, і прочитайте повідомлену причину. Переконайтеся, що значення ключового слова є рядком, що шаблон розбирається і що кожен шлях, яким він проходить, справді є у значенні, що перевіряється, — предикат читає значення як .value, і звернення до чогось іншого є найпоширенішою помилкою. Якщо причина називає ключ, якого не знайшла index, перевірте наявність ключа за допомогою hasKey або прочитайте його через get: index зупиняє збірку на ключі, якого в мапі немає, як описано нижче в розділі «A template indexes a map with a key the map does not hold». Переконайтеся, що шаблон зрештою видає true або false: порівняння це робить, а шаблон, який лише рендерить значення, — ні.

A Workload does not satisfy the Workload schema (Сутність Workload не відповідає схемі Workload)

Блок workload: сутності Recipe або FeatureRecipe було прочитано й перевірено за схемою Workload, і одне чи кілька полів їй не відповідають — ключ з помилкою в написанні, значення неправильного типу, пропущене обов’язкове поле, значення поза оголошеним діапазоном чи переліком.

Звіт згрупований: одна зупинка містить усі помилкові поля, тож сутність Workload із чотирма помилками повідомляє про всі чотири за одну збірку, а не по одній за збірку. Заголовок називає Workload, сутність Recipe, яка його оголошує, і файл; кожна знахідка під ним називає шлях поля всередині Workload, що вимагала там схема, і виправлення, якщо його можна сформулювати.

Повідомлення, що виводиться:

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

Збій без подробиць для окремих полів — блок узагалі не вдалося прочитати, а не прочитано й визнано невідповідним — натомість містить усю причину як єдину знахідку.

Якщо шаблон workload: читає значення, оголошене чутливим, жодна знахідка не цитує значення. Неможливо визначити, яке поле відрендереного документа походить від цього значення, тому кожна знахідка, текст якої міг би містити значення, наводить обмеження схеми з <redacted> на місці значення, завершується приміткою з причиною і не містить виправлення, виведеного зі значення:

.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)

Знахідка, що не цитує значення, — відсутній ключ, ключ, якого Workload не допускає, — читається так само, як для будь-якого іншого шаблону. Див. vocabulary/compact-form-authoring.md «Що відмова повідомляє про оголошене значення».

Збірка повідомляє про зупинку з тегом CATALOG_ERROR, оскільки блок workload: пише автор сутності Recipe, а не сутності Aggregate чи Release.

Як виправити: відкрийте сутність Recipe за вказаними шляхами полів і виправте кожне. Шляхи задано від власного кореня Workload, тож .containers.main.health.ready — це блок ready під ключем health контейнера main. Іменований контейнер адресується своїм ключем, а init-контейнер — своєю позицією, тому вони читаються по-різному. Що приймає кожне поле, описано в довіднику з написання Workload.

Поле, яке схема очікує як текст і яке відхилено, бо значення є числом або булевим, майже завжди означає шаблонний вираз без лапок. Блок workload: рендериться до перевірки, тож вираз, записаний без лапок, розгортається в голий текст, а YAML потім читає цей текст як те, на що він схожий. Кількість цілих ядер, версія лише з цифр, порт і слова yes, no, on та off читаються не як текст. Знахідка повідомляє, який тип прочитав YAML, а рішення — взяти вираз у лапки в сутності Recipe — cpu: "{{ .infra.compute.cpu }}" замість cpu: {{ .infra.compute.cpu }}, — щоб значення залишалося текстом, хоч би що надав оператор. Зауважте, що власне значення оператора тут не винне, і взяття його в лапки в сутності Release нічого не змінює: лапки мають бути в сутності Recipe, навколо виразу.

Вкладення Workload називає слот, який сутність не оголошує, або спосіб доставки, який слот забороняє

Запис attachments: контейнера всередині блоку workload: посилається на слот вкладення, і це посилання не узгоджується зі слотами, які Component або Feature оголошує у своєму featuresSchema, — або, для запису, що називає з’єднання через connection:, зі слотами, які оголошує сокет цього з’єднання. Запис envFrom, що називає з’єднання, підлягає тим самим правилам для з’єднань. Знахідка повідомляє, який із цих випадків маєте ви.

  • Слот не оголошено. from: запису називає слот, якого немає в featuresSchema сутності, — помилка в написанні або слот, перейменований лише з одного боку.
  • Слот є blackbox. Слот оголошує порожній список дозволених inject:, що залишає доставку власній внутрішній механіці Recipe. Такий слот заповнюється та споживається внутрішньо, тож Workload не може до нього звертатися.
  • Спосіб доставки поза списком дозволених слота. as: запису називає механізм, який список inject: слота не дозволяє.
  • Компонент не проводить такого з’єднання. connection: запису називає псевдонім, під яким не записано жодного з’єднання компонента.
  • Сокет з’єднання не оголошує слот. from: запису (або, в envFrom, secret:) називає слот, якого не оголошує сокет, через який під’єднано це з’єднання.
  • Слот записано його складеним ім’ям. from: (або secret:) запису — це ім’я, яке вкладення з’єднання отримує на компоненті, — псевдонім, крапка і слот, — записане без connection:. До слота з’єднання можна звернутися лише назвавши з’єднання.

Про всі помилкові записи в усіх контейнерах повідомляється разом, тож одна збірка називає їх усі. Знахідки згруповано під одним заголовком, що називає Workload, його Recipe і файл.

Повідомлення, що виводиться:

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>

У записі envFrom ті самі знахідки розташовані за шляхами .containers.<name>.envFrom[<i>].connection і .containers.<name>.envFrom[<i>].secret.

Як виправити: кожна знахідка називає обидві сторони, тож вибір полягає в тому, яку сторону змінити. Для неоголошеного слота виправте написання from: або оголосіть слот у featuresSchema сутності — суфікс .from у шляху поля вказує на посилання. Для слота blackbox видаліть посилання з боку Workload і дозвольте Recipe доставити матеріал, якщо тільки доставка з боку Workload справді не потрібна, — тоді задайте слоту список дозволених inject:. Для відхиленого механізму змініть as: на той, що є у списку дозволених, або додайте свій до нього. Для з’єднання, якого компонент не проводить, виправте псевдонім на один із тих, що перелічує знахідка, або проведіть з’єднання в сутності Aggregate чи Release. Для слота, якого не оголошує сокет, назвіть один зі слотів, що перелічує знахідка, або оголосіть слот у featuresSchema сокета в сутності Component. Для складеного імені запишіть з’єднання і слот окремо, як показує знахідка.

Workload посилається на слот, заповнення якого не публікує локатора

Запис attachments: контейнера називає слот за посиланням, а вкладення, що заповнює цей слот, не публікує ключів provides, які читає таке посилання. Посилання на слот за іменем означає запит на те, щоб ресурс, який він представляє, був адресований у згенерованому виводі — за іменем ресурсу та за полем усередині нього. Заповнення, що не публікує жодного з них, не має локатора, на який можна вказати, тож посилання неможливо ні на що перетворити.

Які ключі потрібні, залежить від запису, і знахідка повідомляє, чого саме вона очікувала. Запис, що називає власний key:, сам задає поле, тож опублікованим має бути лише name ресурсу — саме це дає змогу посилатися на ресурс із кількома ключами. Запис, що не називає key:, читає єдине опубліковане поле слота, тож мають бути присутні і name, і key.

Перевірка читає лише наявність ключів; вона ніколи не перевіряє їхніх значень. Про всі помилкові записи повідомляється разом, під одним заголовком.

Повідомлення, що виводиться:

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

Як виправити: є два напрями, і правильний залежить від того, що ви мали на увазі. Якщо посилання правильне, змінити слід вкладення, що заповнює слот: вкладіть Feature, чий schema.provides оголошує name — і key, якщо запис не називає власного, — щоб був локатор, на який можна вказати. Якщо матеріал ніколи не мав адресуватися за іменем у виводі, приберіть посилання й доставте його натомість через канал inject: слота, який передає саме значення, а не вказівник на те, де воно розташоване.

A container gives one environment variable two values (Контейнер задає одній змінній середовища два значення)

Один контейнер блоку workload: називає ту саму змінну середовища двічі: один раз як ключ своїх variables і один раз як ключ запису attachments, що доставляється as: env. Перевіряються і основний контейнер, і контейнер ініціалізації — однаково в сутності Workload, яку рендерить Recipe компонента, і в сутності Workload, яку рендерить FeatureRecipe, — як прикріпленій до компонента, так і оголошеній на межі, — і перевірка читає Workload у тому вигляді, у якому його відрендерив шаблон.

Чому збірка зупиняється, а не вибирає одне. Середовище контейнера записується з цих двох колекцій у фіксованому порядку — провайдери helm і compose спершу записують кожен запис, прочитаний із прикріплень, а прості variables — після них. Тож ім’я, записане обома способами, дійшло б до процесу з тим значенням, якому цей порядок дозволяє перемогти, а це наслідок того, куди потрапляють два види записів, а не того, що ви написали, тому збірка відхиляє таку пару замість того, щоб її рендерити. Перевірка виконується один раз, незалежно від того, який провайдер рендерить Workload, після інших перевірок Workload і до того, як обчислюються записи artifacts: або Workload передається будь-якому провайдеру, тож відхилену пару ніколи не буде відрендерено. Запис attachments, що доставляється as: file, монтується як файл, а не задається в середовищі, тому ніколи не утворює пари.

Перевірка порівнює лише імена; вона ніколи не читає значення, тому жоден результат його не цитує. Два види записів середовища не входять до того, що вона порівнює: запис envFrom задає ключі ConfigMap або Secret, які він називає, а вони невідомі під час збірки, а запис, який крок конвеєра записує у відрендерений документ, не є частиною Workload, який читає перевірка.

Кожна пара — окремий результат, розташований на ключі workload: сутності Recipe або FeatureRecipe, що оголошує Workload, і він називає змінну та контейнер — основний контейнер за його ключем, контейнер ініціалізації за його місцем у списку initContainers. Результати надходять так: спершу основні контейнери в порядку їх написання, потім контейнери ініціалізації за позицією, а в межах одного контейнера — у порядку написання його записів attachments.

Повідомлення, що виводиться, для пари в основному контейнері Workload сутності Recipe. Категорія та короткий код цієї умови, E0345, доходять до вас у заголовку в квадратних дужках, а позиція має вигляд <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 (контейнер оголошує одну змінну середовища двічі. Перейменуйте одну з двох або запишіть їх під взаємодоповнювальними умовами шаблону, щоб рендерилася лише одна з них)

Пара в контейнері ініціалізації натомість називає його місце в списку — init container "initContainers[<i>]", — а результат для FeatureRecipe після контейнера називає прикріплення, яке його прив’язує, attachment "<attachment>", бо компонент може мати кілька прикріплень, чиї FeatureRecipes є окремими документами.

Якщо один Workload має кілька пар, результати групуються під рядком, що називає документ: containers of the Workload this Recipe renders name one environment variable twice (контейнери Workload, який рендерить ця Recipe, називають одну змінну середовища двічі) або, для FeatureRecipe, containers of the Workload rendered by the FeatureRecipe that attachment "<attachment>" binds name one environment variable twice (контейнери Workload, відрендереного сутністю FeatureRecipe, яку прив’язує прикріплення, називають одну змінну середовища двічі).

Збірка повідомляє про зупинку з тегом CATALOG_ERROR, бо блок workload: пише автор сутності Recipe або FeatureRecipe, а не Aggregate чи Release.

Як виправити: вирішіть, яке з двох значень має отримати контейнер. Якщо потрібні обидва, перейменуйте одне з них, щоб процес бачив дві змінні. Якщо це альтернативи — скажімо, простий запасний варіант на випадок, коли облікові дані не прикріплено, — захистіть їх взаємодоповнювальними умовами, щоб рендерилася рівно одна: запишіть змінну під {{ if not (hasKey (default dict .features) "<slot>") }}, а запис attachments — під {{ if hasKey (default dict .features) "<slot>" }}, або під двома гілками одного {{ if }}/{{ else }}. Пара, захищена таким чином, ніколи не доходить до перевірки, бо у відрендереному Workload є лише одне з двох.

A Release’s parameters: block is written in neither of its two shapes (Блок parameters: сутності Release записано в жодній із двох його форм)

Сутність Release виконує параметри, які оголосив Aggregate, одним із двох способів, і блок читається за його формою. Це або зіставлення імен параметрів зі значеннями, записаними на місці, або зіставлення рівно з одним ключем, $import:, значенням якого є шлях до YAML-файлу з цими значеннями. Блок, що не є жодним із них, відхиляється під час читання, ще до того, як щось перевірить значення щодо оголошень Aggregate.

Відхиляються три форми. Значення parameters:, яке взагалі не є зіставленням, — скаляр або список. Зіставлення, що містить $import: поряд з іншими ключами, яке вимагає імпортованих і записаних значень одночасно й не дає правила їх поєднання. І $import:, значення якого не є простим рядком, що не називає жодного файлу.

Схема Release оголошує ті самі дві форми, тож файл Release з будь-якою з трьох помилок спершу стикається з перевіркою оболонки документа під E0215, яка пробує обидві форми й повідомляє, чому кожна не підійшла, — тут для списку:

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 (валідація оболонки документа не пройдена (Release); spec.parameters: не підійшла жодна гілка oneOf (перевірено 2 гілки): branch[0]: тип: очікувався об’єкт, отримано масив; branch[1]: тип: очікувався об’єкт, отримано масив. виправте документ відповідно до схеми його виду)

Для $import: поруч з іншим ключем друга гілка закінчується на additionalProperties: unexpected property: "<key>", а для $import:, записаного списком, а не рядком, — на validation: type: array has type "array", want "string".

Повідомлення, що виводиться, коли значення не є зіставленням, називає те, що там записано, — наприклад, a list:

parameters: shape must be an inline object or {$import: }: line <line>: <shape> is written where a map is expected (parameters: форма має бути вбудованим об’єктом або зіставленням лише з $import: там, де очікується зіставлення, записано інше)

і коли $import: ділить зіставлення з чимось іншим або називає щось, що не є шляхом:

parameters: shape must be an inline object or {$import: }: $import: must be the only key (got <n> keys) at line <line> (parameters: форма має бути вбудованим об’єктом або {$import: локальний шлях}: $import: має бути єдиним ключем) parameters: shape must be an inline object or {$import: }: $import value must be a string scalar at line <line> (parameters: форма має бути вбудованим об’єктом або {$import: локальний шлях}: значення $import має бути рядковим скаляром)

Як виправити: відкрийте сутність Release на рядку, який називає повідомлення. Запишіть значення на місці під parameters: або замініть увесь блок одним записом $import:, значенням якого є шлях у лапках. Якщо вам потрібні і записані значення, і імпортований файл зі спільними типовими значеннями, перенесіть записані значення в сутність Release, яка через extends: розширює ту, що містить імпорт, — шарування кількох джерел параметрів є саме тим, для чого існує ланцюжок extends:, а цей один ключ за задумом читається з одного джерела.

An inline-or-import field is written in neither shape (Поле «вбудоване або імпортоване» не записане в жодній із двох форм)

Три поля, які записує Recipe або FeatureRecipe, — запис artifacts.<name>:, valuesMapping: і workload: — приймають ті самі дві форми. Або тіло записано на місці як рядковий скаляр (для будь-чого багаторядкового зазвичай використовують блок |), або значення є відображенням рівно з одним ключем, $import:, що натомість вказує, де міститься тіло. Те, що може вказувати $import:, залежить від поля: запис artifacts імпортує локальний шлях або пакет з ArtifactLibrary, тоді як valuesMapping: і workload: імпортують локальний шлях або запис з бібліотеки за ідентичністю.

Усі три поля перевіряє один зчитувач, тож відмови однакові, хоч би яке поле було помилковим: відображення з кількома ключами, відображення, єдиний ключ якого не $import, і $import:, значення якого не є простим рядком. Значення, що не є ні скаляром, ні відображенням, — найчастіше список, — відхиляється вже через саму форму. Див. також $import:.

Схеми Recipe і FeatureRecipe оголошують ті самі дві форми для кожного з трьох полів, тож файл із будь-якою з цих помилок спершу стикається з перевіркою оболонки документа під E0215, яка називає поле й повідомляє, чому не підійшла кожна форма, — перша гілка відповідає формі, записаній на місці, друга — формі з $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 (валідація оболонки документа не пройдена (Recipe); для цього запису spec.artifacts не підійшла жодна гілка oneOf (перевірено 2 гілки): branch[0]: валідація: тип — об’єкт, очікувався рядок; branch[1]: additionalProperties: неочікувана властивість. виправте документ відповідно до схеми його виду)

Це зіставлення, у якому поруч із $import: є інший ключ. Єдиний ключ, що не є $import, закінчується на required: missing required property: $import, additionalProperties: unexpected property: "<key>", список — на type: expected object, got array, а $import:, що не є рядком, називає тип, знайдений там, де очікувався рядок, як у type: array has type "array", want "string".

Повідомлення, що виводяться. Кожне починається реченням для помилкового поля, а потім повідомляє, що знайшов зчитувач і де:

artifacts entry: shape must be a string scalar or {$import: }: got <n> keys at line <line> (запис artifacts: форма має бути рядковим скаляром або {$import: локальний шлях}: отримано n ключів у рядку line) valuesmapping: shape must be a string scalar or {$import: }: got key "<key>" at line <line> (valuesmapping: форма має бути рядковим скаляром або {$import: шлях або ідентичність бібліотеки}: отримано ключ key у рядку line) workload: shape must be a string scalar or {$import: }: $import value must be a string scalar at line <line> (workload: форма має бути рядковим скаляром або {$import: шлях або ідентичність бібліотеки}: значення $import має бути рядковим скаляром у рядку line)

Будь-яке з трьох полів може повідомити будь-яке з цих закінчень; значення, що не має жодної з форм, закінчується на line <line>: <shape> is written where text or a map is expected, що називає записане — найчастіше a list.

Як виправити: відкрийте сутність у рядку, який називає повідомлення. Запишіть тіло на місці як блоковий скаляр або замініть усе значення одним записом $import:. Відображення, що містить $import: і щось іще, не є жодною з двох форм — перенесіть зайві ключі в імпортований файл або запишіть тіло на місці. Хибно написаний $import — найчастіше без $ — читається як звичайний ключ і повідомляється як єдиний ключ, що не є $import.

A reference to a library entry carries whitespace (Посилання на запис бібліотеки містить пробільні символи)

Посилання, що називає запис усередині бібліотеки, записується як один нерозривний токен: бібліотека, необов’язкова нижня межа версії :<version>, потім # і шлях до запису — BaseWorkloads:1.0.0#/workloads/StatelessService. Жодна його частина не допускає пробільних символів. Схеми бібліотек обмежують і назви бібліотек, і назви записів написанням ідентифікаторів, а версія — це версія, тож пробіл, табуляція чи розрив рядка будь-де в посиланні не належить жодній із трьох частин.

Відмова стосується кожного місця, яке звертається до запису бібліотеки за ідентичністю: valuesMapping:, workload: і запису artifacts.<name>:, записаних як $import:, а також $ref: схеми. Локальний шлях, записаний як $import:, не містить # і не є посиланням на запис бібліотеки, тож шлях із пробілом не зачіпається.

Відмовляти, а не підчищати, варто тому, що початкова частина такого значення зазвичай сама є посиланням. Обрізання на пробільному символі розв’язало б це посилання і непомітно відкинуло б решту написаного автором — а дві половини збірки не зобов’язані відкидати однаковий обсяг, тож одна могла б записати залежність, якої інша ніколи не бачила. Відмова зберігає за значенням один зміст.

Про відмову повідомляється в рядку документа, з якого прочитано посилання:

library reference: a reference to a library entry carries no whitespace or line break: $import target "<reference>" at line <line> (посилання на бібліотеку: посилання на запис бібліотеки не містить пробілів чи розривів рядка: ціль $import reference у рядку line)

Посилання потрапляє до збірки ще з одного місця: з тіла запису бібліотеки, яке збірка вже розв’язала і де $import: у корені поля в першому рядку вказує на запис іншої бібліотеки. Це посилання ніколи не читалося з документа, який відкрила збірка, тому про нього повідомляється без рядка:

library reference: a reference to a library entry carries no whitespace or line break: "<reference>" (посилання на бібліотеку: посилання на запис бібліотеки не містить пробілів чи розривів рядка: reference)

Як виправити: відкрийте сутність у рядку, який називає повідомлення, і зімкніть посилання в один токен. Звичайна причина — розрив рядка перед #: посилання, перенесене на два рядки, щоб умістити його в колонку, для YAML читається як одне значення, а тут — як пошкоджене посилання, тож пишіть його в одному рядку, хоч би яким довгим він був. Інша причина — кінцевий пробіл перед закривальною лапкою: він потрапляє в нижню межу версії, де називає версію, якої не має жоден опублікований артефакт. Для другої форми посилання міститься в бібліотеці, названій у повідомленні безпосередньо перед ним; виправте його там, де ця бібліотека оголошує запис.

A library entry’s body is not the shape that library holds (Тіло запису бібліотеки не має форми, яку містить ця бібліотека)

Бібліотека публікує іменовані тіла, які імпортують інші сутності, і кожен вид бібліотеки містить одну форму. Запис MappingLibrary і запис WorkloadLibrary містять одне тіло шаблону, тож значення запису — скаляр, на практиці блок |. Запис ArtifactLibrary містить пакет: файли, що належать разом під одною назвою, тож запис є відображенням імені вихідного файлу на тіло цього файлу, і кожне тіло в ньому — скаляр.

Тіла зберігаються точно так, як записані, і не розбираються під час завантаження бібліотеки. Шаблон у тілі розбирається там, де його імпортують, тому тут перевіряється лише форма — тіло, що взагалі не є шаблоном, завантажується без зауважень і завершується помилкою там, де щось його рендерить.

Повідомлення, що виводяться, кожне називає рядок і те, що там записано, — наприклад, a list:

mappinglibrary: entry body must be a string scalar: line <line>: <shape> is written where text is expected (mappinglibrary: тіло запису має бути рядковим скаляром: там, де очікується текст, записано інше) workloadlibrary: entry body must be a string scalar: line <line>: <shape> is written where text is expected (workloadlibrary: тіло запису має бути рядковим скаляром: там, де очікується текст, записано інше) artifactlibrary: entry must be a mapping of filename to a string body: line <line>: <shape> is written where a map is expected (artifactlibrary: запис має бути зіставленням імені файлу з рядковим тілом: там, де очікується зіставлення, записано інше)

і для пакета, запис якого є відображенням, але один із файлів якого не є скаляром, — із назвою файлу:

artifactlibrary: entry must be a mapping of filename to a string body: file "<filename>": line <line>: <shape> is written where text is expected (artifactlibrary: запис має бути зіставленням імені файлу з рядковим тілом: у цьому файлі там, де очікується текст, записано інше)

Збірка повідомляє про це під тегом CATALOG_ERROR, що називає файл, який вона читала, а під ним наведено речення вище.

Як виправити: запишіть тіло як блоковий скаляр під його ключем. Тіло, перший рядок якого схожий на ключ YAML, — а шаблон, що створює YAML, зазвичай такий, — без блокового скаляра читається як вкладене відображення, і це поширена причина. Для ArtifactLibrary запишіть по одному ключу на кожне ім’я вихідного файлу, кожне тіло — окремим блоковим скаляром; пакет, записаний як одне тіло, — інша поширена помилка форми.

A $instantiate: reference cannot be resolved (Посилання $instantiate: неможливо розв’язати)

SchemaLibrary може оголошувати багаторазові форми в spec.templates, кожну зі своїми $params, а запис схеми потім створює екземпляр однієї з них, називаючи її в $instantiate: і передаючи її параметри в $args:. Підстановка буквальна: скаляр $<name> у тілі шаблону замінюється значенням аргументу. Немає обчислення виразів, умов чи циклів, а підставлене значення вставляється як є, без повторного пошуку в ньому інших маркерів.

Створення екземпляра відхиляють три помилки. Ім’я в $instantiate: не є тим, що оголошує бібліотека. Параметр, який шаблон оголошує без default:, не має запису в $args:. Або значення аргументу не має типу, який оголошує його параметр, — і ключ у $args:, що не називає жодного оголошеного параметра, повідомляється так само, а не ігнорується, тож помилка в імені аргументу стає відмовою, а не непомітно встановленим за замовчуванням параметром.

Повідомлення, що виводяться:

schemalibrary: template not found: "<template-name>" not declared in spec.templates schemalibrary: template parameter missing: "<parameter-name>" (template "<template-name>") schemalibrary: template parameter type mismatch: <what the type check found> schemalibrary: template parameter type mismatch: argument "<argument-name>" is not declared in template "<template-name>"’s $params

Як виправити: якщо шаблон не знайдено, виправте ім’я на те, яке бібліотека оголошує в spec.templates, — і перевірте, що імпортуєте саме ту бібліотеку. Якщо бракує параметра, додайте його до $args: або задайте параметру default: у шаблоні, щоб викликачі могли його пропускати. У разі невідповідності типу змініть аргумент на оголошений тип або розширте type: параметра; якщо повідомлення називає неоголошений аргумент, виправте його написання або видаліть його.

A schema uses a JSON Schema keyword the library does not admit (Схема використовує ключове слово JSON Schema, яке бібліотека не допускає)

$dynamicAnchor і $dynamicRef не допускаються у вмісті SchemaLibrary. Вони відкладають визначення того, до якої схеми розв’язується посилання, до моменту валідації значення, через що значення запису бібліотеки залежить від того, звідки його імпортовано, а не від того, що в ньому написано, — а компілятор розв’язує форми бібліотеки до будь-якої валідації, тож відкладеному посиланню немає проти чого розв’язуватися.

Відмова застосовується у трьох точках, які разом закривають обидва шляхи, якими може потрапити ключове слово. Запис схеми перевіряється під час завантаження бібліотеки. Тіло шаблону перевіряється під час завантаження бібліотеки, тож шаблон, що буквально містить ключове слово, падає саме тоді, а не в тій збірці, яка першою створить його екземпляр. І підставлене тіло перевіряється ще раз після створення екземпляра, тож передача ключового слова як значення аргументу не обходить перших двох перевірок.

Повідомлення, що виводиться:

schemalibrary: forbidden JSON Schema keyword: "$dynamicRef" at line <line>

Як виправити: замініть відкладене посилання на $ref, що прямо називає запис $defs. Якщо форма справді відрізняється між використаннями, виразіть цю варіативність як шаблон із $params і створюйте його екземпляр для кожного використання — це та підстановка, яку пропонує ця поверхня, і вона розв’язується до того, як щось валідується проти результату.

A document nests deeper than the reader will descend (Документ вкладений глибше, ніж спускатиметься читач)

Кожне написане зіставлення зчитується в структуру, що зберігає порядок, у якому записано його ключі, бо цей порядок потрапляє у згенерований вивід і є частиною того, що робить збірку побайтово ідентичною між запусками. Цей читач спускається на обмежену кількість рівнів — сто — і відмовляється йти глибше, тож вхідні дані, які інакше вичерпали б власний стек читача, повідомляються як відмова, якою вони і є.

Повідомлення, що виводиться:

a document nests too many levels deep: it is read at most 100 levels deep (документ має надто глибоку вкладеність: читається щонайбільше 100 рівнів)

Як виправити: справжні написані вручну документи мають кілька рівнів вкладеності, тож документ, що сягає ста, згенерований, машинно перекладений або випадково посилається сам на себе. Шукайте значення, яке розгорнулося саме в себе: YAML-якір, що посилається на вміст, у якому розташований, відхиляється власною зупинкою вище, а генератор, що повторно виводить ту саму форму, — ні. Якщо глибина справжня, винесіть глибоку гілку в окрему сутність і посилайтеся на неї за ім’ям.

A provider declares a well-known annotation at a scope it does not render (Провайдер оголошує загальновідому анотацію в області, яку він не рендерить)

Plugin, що обслуговує провайдер, каже про себе дві речі, які мають узгоджуватися. У spec.provider.wellKnownAnnotations він перелічує анотації, на які реагує, кожну з областями, в яких він їх читає. У contract.inputKinds він каже, які види вхідних даних він узагалі рендерить. Ключ, оголошений в області, вид вхідних даних якої ця сама сутність не заявляє, означає, що ці два твердження суперечать одне одному в одному файлі, тож сутність відхиляється під час завантаження.

Перевірка — це порівняння сутності із самою собою, тому їй не потрібен двійковий файл плагіна і вона спрацьовує всюди, де читається сутність, — зокрема під час обходу каталогу на машині, яка ніколи не завантажувала артефакт.

Два види записів навмисно не порівнюються. Запис з областю межі не називає виду вхідних даних, бо він розв’язується один раз для всієї межі, а не на шляху рендерингу якогось окремого вузла. Запис, що не оголошує жодної області, не робить жодних тверджень щодо шляхів: він лише каже, що плагін десь читає цей ключ.

Чого відмова не встановлює, то це того, що декларація, яка лишилася, правдива. Ніщо не може довести, що плагін, який обслуговує провайдер, читає ключ, який, за його словами, він читає; порівняння двох написаних полів може лише відхилити пару, яка не може бути правдивою водночас. Ключ, оголошений в області, яку провайдер справді рендерить, але чий плагін нічого там не читає, тут проходить.

Повідомлення, що виводиться:

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

Як виправити: повідомлення називає обидві половини. Або приберіть цю область зі списку scope: анотації, залишивши області, які провайдер справді рендерить, або заявіть вид вхідних даних у contract.inputKinds, якщо провайдер насправді його рендерить.

A compact-form schema uses a keyword the compact form does not know (Схема в компактній формі використовує ключове слово, якого компактна форма не знає)

Схема, написана в компактній формі, містить ключ, який не є ні ключовим словом компактної форми, ні одним із ключових слів JSON Schema, які форма пропускає без змін, ні одним із трьох маркерів, які форма резервує, — $jsonschema:, $mode: і $ref:. Невідомі ключі відхиляються під час читання схеми, а не відкидаються, бо помилково написане обмеження, яке ігнорується, перестає бути обмеженням узагалі, а схема, яка здається чинною, але нічого не перевіряє, гірша за схему, що завершується помилкою.

Ця відмова виникає скрізь, де компілюється схема. Записи сутності SchemaLibrary компілюються під час завантаження каталогу; spec.schema сутності Component, її valueSchema і infraSchema для кожного сокета, а також схеми, які оголошують сутності Feature і Plugin провайдера, компілюються під час читання каталогу. spec.schema сутності Component чи Feature сама повідомляє про цю умову, називаючи сутність і поле; valueSchema або infraSchema сокета повідомляє у складі «A declared schema contract cannot be read as a schema (Оголошений контракт схеми не вдається прочитати як схему)» нижче, і процитоване тут речення є її деталлю.

Власне речення компілятора компактної форми називає позицію всередині схеми, рядок джерела та ключ, який він не розпізнав:

compactform at <path-inside-the-schema>:<line> (keyword "<key>"): unknown keyword (compactform у <path-inside-the-schema>:<line> (ключове слово “<key>”): невідоме ключове слово)

Ключ, написаний поруч із міждокументним $ref:, повідомляється за тією самою умовою, з окремим реченням, бо такий посилання може супроводжувати лише три сусідні ключі:

compactform at <path-inside-the-schema>:<line> (keyword "<key>"): cross-document $ref sibling not allowed (allowed: properties, required, description) (compactform у <path-inside-the-schema>:<line> (ключове слово “<key>”): сусідній ключ біля міждокументного $ref не дозволено (дозволено: properties, required, description))

а там, де цей сусідній ключ мав повторно відкрити об’єднану форму, речення натомість підказує, як це зробити:

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 (compactform у <path-inside-the-schema>:<line> (ключове слово “additionalProperties”): сусідній ключ біля міждокументного $ref не дозволено (дозволено: properties, required, description); використайте $jsonschema:, щоб вбудувати схему відкритого об’єкта, якщо об’єднана форма має приймати довільні властивості)

Умова, під якою це реєструється, — compactform: unknown keyword, саме до неї розв’язується її короткий код.

Як виправити: виправте ключ у позиції, яку називає речення, звіривши його зі словником ключових слів у compact-form-authoring.md — найчастіша причина — помилка в написанні. Якщо форма справді потребує ключового слова JSON Schema, якого компактна форма не має, напишіть цей фрагмент під $jsonschema:, що вбудовує JSON Schema дослівно. Поруч із міждокументним посиланням залишайте лише properties:, required: і description:; усе інше належить до запису бібліотеки, на який вказує посилання.

A compact-form schema declares a field literally named type (Схема в компактній формі оголошує поле з буквальною назвою type)

Компактна форма визначає, що означає відображення, за формою його вмісту: ключ type: позначає лист-обмеження, структурні ключові слова JSON Schema позначають фрагмент, який слід пропустити без змін, а відображення простих імен позначає об’єкт, дочірні елементи якого є схемами. Схема, що оголошує поле з назвою type, — єдина форма, яку ці прочитання не можуть розрізнити: вона схожа на лист-обмеження, а задумана як об’єкт з одним полем, — тож форма просить автора вказати, що саме мається на увазі, ключем $mode: зі значенням compact або jsonschema.

Саме цю умову повідомляє $mode:, написаний з будь-яким іншим значенням. Маркер існує, щоб усунути неоднозначність, тож значення, яке нічого не усуває, відхиляється, а не вгадується.

Власне речення компілятора компактної форми:

compactform at <path-inside-the-schema>:<line> (keyword "$mode"): value must be compact or jsonschema (compactform у <path-inside-the-schema>:<line> (ключове слово “$mode”): значення має бути compact або jsonschema)

Умова, під якою це реєструється, — compactform: ambiguous dispatch — $mode required, саме до неї розв’язується її короткий код.

Як виправити: задайте $mode: compact, якщо відображення — об’єкт компактної форми, серед полів якого випадково є поле з назвою type, або $mode: jsonschema, якщо відображення — фрагмент JSON Schema, який слід узяти як написано. Якщо жодне з прочитань не малося на увазі, перейменування поля усуває неоднозначність узагалі без маркера.

A $jsonschema: escape carries content that is not a schema (Екранування $jsonschema: містить вміст, який не є схемою)

Ключ $jsonschema: вбудовує фрагмент JSON Schema дослівно — для форм, які компактна форма не виражає. Те, що він вбудовує, береться як написано і ніколи не перетворюється, тож воно має бути схемою: блоковим скаляром, що розбирається як YAML, або вкладеним відображенням. Вміст, що не є ні тим, ні іншим, відхиляється тут, а не передається далі для валідації, де помилку було б повідомлено щодо споживача схеми, а не щодо самої схеми.

За цією умовою повідомляються чотири форми, і речення вказує, яка з них у вас. Тіло екранування не розбирається як YAML. Значення екранування не є ні блоковим скаляром, ні відображенням. Ключ properties: містить щось, що не є відображенням імен на схеми. І на найзовнішньому рівні документ, переданий компілятору, порожній або містить вузол, для якого читач не має правила.

Власні речення компілятора компактної форми:

compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): escape content does not parse as YAML: <what the parse reported> (compactform у <path-inside-the-schema>:<line> (ключове слово “$jsonschema”): вміст екранування не розбирається як YAML: <what the parse reported>) compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): expected block-scalar string or nested mapping (compactform у <path-inside-the-schema>:<line> (ключове слово “$jsonschema”): очікувався рядок-блоковий скаляр або вкладене відображення) compactform at <path-inside-the-schema>:<line> (keyword "properties"): expected a mapping of property names to schemas (compactform у <path-inside-the-schema>:<line> (ключове слово “properties”): очікувалося відображення імен властивостей на схеми) compactform: unsupported YAML node kind (compactform: непідтримуваний вид вузла YAML)

Умова, під якою це реєструється, — compactform: $jsonschema content invalid, саме до неї розв’язується її короткий код.

Як виправити: напишіть тіло екранування як блоковий скаляр під $jsonschema: — інакше тіло, перший рядок якого читається як ключ YAML, поглинається навколишнім відображенням, і це поширена причина, — і перевірте, що його вміст сам по собі є коректною JSON Schema. Якщо фрагмент був достатньо малим, щоб виразити його в компактній формі, простіше відмовитися від екранування.

A compact-form constraint does not apply to the type it was written on (Обмеження компактної форми не застосовне до типу, на якому його написано)

Обмеження компактної форми розподіляються за оголошеним типом поля: min: і max: стають числовою межею для числа, межею довжини для рядка та межею кількості для масиву. Тож обмеження має стояти на полі, тип якого його приймає, а тип має бути одним значенням, щоб розподіл узагалі мав відповідь.

За цією умовою повідомляються чотири форми. Обмеження, написане там, де type: відсутній або називає об’єднання, тож ніщо не визначає, яку межу малося на увазі. Обмеження, написане на типі, що не приймає межі такого виду, — об’єкті чи булевому значенні. type:, значення якого не є ні скалярним іменем, ні послідовністю імен. І valuesType:, якому задано щось інше, ніж скалярне ім’я.

Власні речення компілятора компактної форми:

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 (compactform у <path-inside-the-schema>:<line> (ключове слово “<constraint>”): обмеження застосовується до одного оголошеного типу (integer/number/string/array); type: не визначено (об’єднання або відсутній) — звузьте type: до одного значення або вилучіть це обмеження) compactform at <path-inside-the-schema>:<line> (keyword "<constraint>"): constraint applies to integer/number/string/array; declared type is <the type as written> (compactform у <path-inside-the-schema>:<line> (ключове слово “<constraint>”): обмеження застосовується до integer/number/string/array; оголошений тип — <the type as written>) 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 (compactform у <path-inside-the-schema>:<line> (ключове слово “type”): очікувалося скалярне ім’я типу або послідовність імен типів (JSON Schema 2020-12 array-of-types); отримано непідтримуваний вид вузла) compactform at <path-inside-the-schema>:<line> (keyword "valuesType"): expected a scalar type name (compactform у <path-inside-the-schema>:<line> (ключове слово “valuesType”): очікувалося скалярне ім’я типу)

Умова, під якою це реєструється, — compactform: constraint not valid for declared type, саме до неї розв’язується її короткий код.

Як виправити: речення називає обидві половини — обмеження і тип, з яким воно зустрілося. Звузьте type: до одного імені, якщо там об’єднання, додайте його, якщо його немає, або вилучіть обмеження, якщо поле справді приймає будь-який із кількох типів. Межа, що має змінюватися залежно від типу, виражається як набір альтернатив під $jsonschema:, де кожна гілка має власний тип і власну межу.

A $ref: is not written in a form the compiler can resolve ($ref: записано не у формі, яку компілятор може розв’язати)

Схема посилається на іншу форму через $ref: — або в межах того самого документа, або між документами, на запис SchemaLibrary. Дві умови охоплюють два способи, у які посилання може не спрацювати, і речення повідомляє, який саме у вас: посилання записано не у формі, яку читає компілятор, або воно коректно сформоване, але називає ціль, якої немає.

Посилання неможливо прочитати. Значення порожнє, або його міждокументна форма не <Library>#/schemas/<Entry>, або версію в ньому відокремлено через @ — про це повідомляється з виправленим написанням, а не загальною скаргою, бо саме цієї помилки найчастіше припускаються в цій формі:

compactform at <path-inside-the-schema>:<line> (keyword "$ref"): expected a non-empty reference URL compactform at <consumer-document> (keyword "$ref"): cross-document $ref shape must be <LibraryName>#/schemas/<EntryName>: <the value as written> compactform at <consumer-document> (keyword "$ref"): cross-document $ref version separator is ’:’, not ’@’ — use <the corrected value>: <the value as written>

Умова, під якою їх реєструють, — compactform: $ref unresolvable.

Цілі немає. Посилання читається правильно, але бібліотеки або запису в ній немає — або взагалі не надано каталогу бібліотек, щодо якого можна розв’язувати:

compactform at <consumer-document> (keyword "$ref"): SchemaLibrary <library> not found in catalog (referenced from <consumer-document>): <the value as written> compactform at <consumer-document> (keyword "$ref"): entry <entry> not found in SchemaLibrary <library>: <the value as written> compactform at <path-inside-the-schema>:<line> (keyword "$ref"): cross-document $ref but no SchemaLibrary catalog supplied: <the value as written>

Умова, під якою їх реєструють, — compactform: cross-document $ref target not found.

Саме розмежування цих двох випадків робить звіт придатним до дії: перший — це значення, яке слід переписати в документі, що ви переглядаєте, а другий — питання про те, що бачить збірка. Посилання, яке розгортається саме в себе, — це ще третій випадок, про нього повідомляється як «A library reference expands into itself (Посилання на бібліотеку розгортається саме в себе)» вище.

Як виправити: для нечитабельного посилання перепишіть значення — <Library>#/schemas/<Entry> для міждокументного посилання, #/$defs/<name> для посилання в межах того самого документа — і використовуйте : перед нижньою межею версії замість @. Для відсутньої цілі перевірте назву запису в бібліотеці, яка його публікує, і переконайтеся, що бібліотека досяжна із замикання залежностей сутності Release: бібліотеку, від якої ніщо не оголошує залежності, не завантажують, тож навіть правильне посилання на неї ні в що не розв’язується.

Коли бібліотека є лише в кеші артефактів. Кеш містить те, що туди поклало завантаження, і кешована бібліотека вважається вмістом каталогу лише тоді, коли запис у lockfile сутності Release засвідчує її дайджест. Коли кеш містить SchemaLibrary, яку не закріплює жоден запис lockfile і не надає жодна директорія каталогу, за повідомленням іде рядок remediation:, що називає кожну таку бібліотеку та дію, яка спрацьовує для команди, що про це повідомила:

  • aggrega build і aggrega validate --release читають lockfile сутності Release, тож їхній рядок називає aggrega pull --release <release>, який розв’язує бібліотеку й фіксує її запис, або створення бібліотеки в директорії каталогу.
  • aggrega validate без аргументів, а також aggrega validate зі шляхом до сутності, незалежно від того, чи задано --release, читають бібліотеки лише з директорій каталогу й не читають жодного lockfile, тож зафіксований запис не змінив би їхнього вердикту. Їхній рядок про це повідомляє й указує на створення бібліотеки в директорії каталогу або на aggrega pull --release <release>, а потім aggrega validate --release <release>, який перевіряє Release за бібліотеками, закріпленими в його lockfile.

Pull, який не знаходить такої бібліотеки, повідомляє про це в розділі A reference names no entity the catalog holds (Посилання називає сутність, якої немає в каталозі) окремим рядком.

A $ref: addresses a library by registry location ($ref: адресує бібліотеку за розташуванням у реєстрі)

Міждокументне $ref: називає свою бібліотеку за ідентичністю — голою назвою бібліотеки, потім # і шляхом до запису — і ніколи за реєстром, у якому її опубліковано. Через який реєстр розв’язується назва, визначає конфігурація робочого простору, а яка версія використовується — lockfile, тож посилання з хостом зафіксувало б у схемі дві речі, які має вирішувати збірка, і при перенесенні схеми між робочими просторами стало б зламаним посиланням.

Якщо значення з хостом усе ж розбирається на бібліотеку й запис, речення містить написання у формі ідентичності, яке слід використати натомість:

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>

а якщо ні, речення закінчується після значення:

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

Умова, під якою це реєструють, — compactform: cross-document $ref carries a registry host; reference the library by identity, саме в неї розв’язується її короткий код.

Як виправити: приберіть хост і все, що стоїть перед назвою бібліотеки, залишивши <Library>#/schemas/<Entry>. Якщо потрібна нижня межа версії, запишіть її після назви бібліотеки як :<version>. Те саме правило стосується полів $import: у сутностях Recipe і FeatureRecipe, про які повідомляється окремо в «A library $import: addresses its library by registry location (Бібліотечний $import: адресує свою бібліотеку за розташуванням у реєстрі)» нижче.

A schema $import: cannot be applied (Неможливо застосувати $import: схеми)

Поле spec.schema сутності Component або Feature — увесь його блок чи один його стовп — а також valueSchema: або infraSchema: сокета usesSchema можна записати як $import:, що називає файл поруч із сутністю. Імпорт застосовується під час завантаження сутності, тож кожен наступний читач бачить імпортований контракт, а не вказівник. Ця умова виникає тоді, коли помилка в тому, що написали ви: у самій директиві або у формі того, що виявилося у файлі, який вона називає.

Ці помилки є однією умовою, бо кожна робить непридатною ту саму поверхню й вимагає від вас того самого — виправити директиву або файл, який вона називає. Діагностика починається з незмінного речення, а потім указує, яка саме помилка, тож речення — це частина для зіставлення, а підрядна частина після нього — те, на що слід реагувати:

a schema $import: could not be applied. <surface>: <the clause for this occurrence> (не вдалося застосувати $import: схеми. <surface>: <the clause for this occurrence>)

Підрядна частина називає прочитану поверхню — spec.schema, її стовп, наприклад spec.schema.values, або valueSchema сокета — і далі конкретну помилку. Помилки та їхнє значення:

  • $import: must be the only key when a schema is imported from a file. ($import: має бути єдиним ключем, коли схему імпортують із файлу.) Директива ділить зіставлення з написаним вручну вмістом схеми. $import: замінює все значення, тож сусідньому ключу немає з чим поєднуватися.
  • $import: value must be a path to a file. (Значення $import: має бути шляхом до файлу.) Значення порожнє або не є одним рядком.
  • $import: takes a file path beside this entity, not a registry location <value>. ($import: приймає шлях до файлу поруч із цією сутністю, а не розташування в реєстрі <value>.) Значення адресує реєстр. Те, через який реєстр розв’язується ім’я, визначає конфігурація робочого простору, тож поверхня схеми ніколи його не містить; повідомлення називає форму посилання, яку слід використати натомість.
  • $import: takes a file path beside this entity; reference the SchemaLibrary entry <value> with $ref: instead. ($import: приймає шлях до файлу поруч із цією сутністю; натомість посилайтеся на запис SchemaLibrary <value> через $ref:.) Значення адресує запис бібліотеки. На запис бібліотеки посилаються, а не імпортують його — саме $ref: є ключовим словом, що його розв’язує.
  • imported schema <value> must be a YAML map of schema content; it is not. (імпортована схема <value> має бути YAML-мапою вмісту схеми; це не так.) Файл знайдено, прочитано й розібрано, але результатом розбору є скаляр або послідовність, тож немає вмісту схеми для підстановки.

Заголовок містить категорію та короткий код цієї умови, E0266, — ідентифікатор, який слід записувати, коли цю зупинку потрібно назвати стабільно: у шлюзі безперервної інтеграції, у задачі чи в runbook. Номер видається один раз і далі не змінюється, тож лишається тим самим, хоч би як покращувалося формулювання навколо нього; таблиця всіх умов його розв’язує.

Директива, яка правильно сформована й називає файл, якого збірка не може отримати, повідомляється в іншому місці, під іншим кодом. Шлях, що не розв’язується, файл, якого немає або який неможливо прочитати, і байти, що не розбираються як YAML, — це не помилки в написаному вами: немає імпортованого документа, який можна оцінити, — тож вони повідомляються як завантаження, яким і є, під «A file cannot be read, or its bytes do not parse (Файл неможливо прочитати або його байти не розбираються)» вище, де задокументовано підрядну частину кожного з них. Зіставляйте з цією умовою та записуйте її код, коли ви відстежуєте відсутній або непрочитний файл імпорту.

Шлях розв’язується відносно каталогу, що містить файл сутності, — тієї самої основи, яку використовує кожне інше поле з імпортом. Імпорт, вміст якого сам оголошує $import:, відстежується далі, а ланцюжок, що повертається до файлу, який уже обробляється, повідомляється як «A library reference expands into itself (Посилання на бібліотеку розгортається саме в себе)» вище, а не тут. Директива, записана всередині файлу, який привніс імпорт, повідомляється в цьому файлі й у рядку в ньому, бо саме там потрібне виправлення; директива, записана в сутності, повідомляється в сутності.

Як виправити: зробіть $import: єдиним ключем у його зіставленні й укажіть відносний шлях до YAML-файлу поруч із сутністю, верхній рівень якого є мапою вмісту схеми. Щоб використати форму, яку публікує SchemaLibrary, застосуйте натомість $ref: <Library>#/schemas/<Entry> — на запис бібліотеки посилаються, а не імпортують його.

A schema block names a key that is not a data pillar (Блок схеми називає ключ, який не є стовпом даних)

Блок spec.schema сутності Component або Feature містить стовпи даних сутності, і лише три ключі він допускає: values — форму, яку розробник заповнює для кожного екземпляра; infra — фізичні розміри, які надає оператор; і provides — ключі, які сутність надає своїм споживачам. Ця умова виникає тоді, коли блок містить на верхньому рівні якийсь інший ключ.

Набір закритий, а не відкритий, з тієї самої причини, з якої власний вміст кожного стовпа перевіряється як закритий: блок, що перелічує допустиму поверхню, робить помилкою все поза нею. Ключ, який ніщо не розпізнає, ніс би контракт, який ніщо ніколи не компілює, не використовує для перевірки й не передає споживачу, — тож написане під ним виглядало б оголошеним, але було б бездіяльним. Це помітити важче, ніж контракт, якого ви взагалі не написали, тому блок відхиляється, а не сторонній ключ ігнорується.

Діагностика починається з незмінного речення, а потім називає сутність, правило, місце, де записано ключ, і що написати натомість:

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. (блок схеми оголошує ключ, який не називає жодного стовпа даних (<Kind> <name>, правило schema-pillars, у .spec.schema.<key>). перейменуйте “<key>” на один із ключів стовпів або вилучіть його разом із контрактом під ним; дозволено: values, infra, provides. Канонічний набір стовпів див. у vocabulary/data-pillars.md.)

Заголовок містить категорію та короткий код цієї умови, E0267, — ідентифікатор, який слід записувати, коли цю зупинку потрібно назвати стабільно: у шлюзі безперервної інтеграції, у задачі чи в runbook. Номер видається один раз і далі не змінюється, тож лишається тим самим, хоч би як покращувалося формулювання навколо нього; таблиця всіх умов його розв’язує.

Дві речі, записані в цьому місці, не є ключами цього набору, і жодна з них не повідомляється тут. $import:, що називає файл поруч із сутністю, замінюється вмістом цього файлу ще до читання блоку, тож ця умова перевіряє власний верхній рівень імпортованого документа — сторонній ключ усередині імпортованого файлу повідомляється тут, а сама директива — ніколи. А сутність Component, що оголошує extends, записує замість блоку простий рядок inherited, тобто скаляр без жодних ключів.

Як виправити: речення називає ключ, який трапився, і три допустимі, тож найпоширеніша причина — описка або однина там, де назва стовпа у множині, — видна з самої діагностики. Якщо вміст під стороннім ключем належить до стовпа, перенесіть його під values:, infra: або provides: відповідно до того, хто ним володіє; data-pillars.md пояснює, який стовп чим володіє. Якщо він задумувався як самостійний вміст схеми, його місце на рівень глибше, всередині стовпа, а не поруч зі стовпами. До форми, яку публікує SchemaLibrary, звертаються через $ref: <Library>#/schemas/<Entry>, записаний усередині стовпа, а не на рівні блоку.

A plugin asks the host to parse a source while a parse is already running for it (Плагін просить хост розібрати джерело, коли для нього вже виконується розбір)

Плагін може попросити хост розібрати джерело й повернути результат, щоб плагіну, якому потрібен документ у певному форматі, не доводилося мати власний засіб читання для нього. Хост запускає плагін, що виконує розбір, і повертає те, що той створив. Ця умова виникає тоді, коли плагін, викликаний у такий спосіб, сам просить про розбір: запит повторно ввійшов би в той самий механізм, усередині якого вже виконується, і хост відмовляє замість заглиблюватися. Механізм пропонує один такий рівень, і саме відмова обмежує його одним.

Відмова надходить до плагіна, а не до збірки. Хост не зупиняється на цьому й не розгортає стек; він відповідає на виклик конвертом помилки, що містить наведене нижче речення та код, який називає відмову, і плагін, що зробив запит, отримує його як відповідь на свій запит. Що далі робить збірка, залежить від того, як цей плагін обробить відповідь: плагін, який вважає її фатальною, завершує збірку, а той, що повідомляє про неї й продовжує роботу, — ні. Сама відмова в обох випадках однакова.

Це не вина жодного з плагінів окремо: захист охоплює будь-яку пару плагінів, через яку пройшов запит, а не одну визначену пару, тож та сама відмова виникає скрізь, де механізм вводиться повторно.

Повідомлення, яке отримує плагін:

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: повторний вхід producer-consumption заборонено: виробник, викликаний через хост, не може здійснювати подальший виклик producer-consumption)

Як виправити: ніщо у ваших власних файлах цього не спричиняє, і жодна зміна в авторському коді цього не усуває — це властивість плагінів, з якими налаштовано збірку. Виправити слід плагін, який просить про розбір зсередини розбору, тож повідомте про цю умову тому, хто його публікує, навівши повідомлення. Якщо це ваш плагін, нехай він читає безпосередньо передане йому джерело, а не просить хост розібрати інше, поки сам обслуговує розбір.

The workspace configuration is invalid (Конфігурація робочого простору недійсна)

Робочий простір описується файлом .aggrega-config.yaml у його корені: до якого реєстру він публікує і з якого завантажує, де розташований кеш артефактів, які плагіни під’єднано до яких сокетів і яка позиція щодо підписування в кожного реєстру. Цей файл читається й перевіряється на відповідність своїй схемі до відкриття будь-якого файлу сутності, оскільки все подальше зчитується з нього.

Відсутній файл не є помилкою. Робочий простір без файлу конфігурації отримує задокументовані значення за замовчуванням, тож ця зупинка ніколи не називає відсутній файл. Вона називає файл, що містив значення, — або, для параметра, який перевизначає змінна середовища і якого схема ніколи не бачить, саму змінну.

Перевірка виконується до перетворення документа на типізовані параметри. Саме такий порядок дає змогу повідомленню назвати шлях поля, проти якого заперечила схема, а не повідомляти про невідповідність типів десь далі, без поля, на яке можна вказати.

Окрім звичайного заперечення схеми, тут повідомляється про такі форми, кожну тому, що сама схема може сказати лише щось надто загальне, щоб на це можна було відреагувати: ключ workspace:, під яким нічого не написано; ключ, місце якого на верхньому рівні, написаний натомість під workspace:; блок cache:, написаний під назвою, якої файл не використовує; хост реєстру, записаний не так, як записується хост реєстру; і три параметри, значення яких схема допускає, але робочий простір використати не може, — artifact_cache_dir, що є абсолютним або називає сам корінь робочого простору, запис signing.kinds, що називає щось, що не є видом артефакту, придатним до публікації, і запис plugins.providers або providers_append, чий uri є розташуванням у реєстрі, записаним з oci://. Прив’язка провайдера називає свій плагін за його ідентичністю, provider/<name> з необов’язковим :<version>, бо саме з цією ідентичністю зіставляється прив’язка, коли розв’язується можливість; розташування в реєстрі каже, де плагін опубліковано, а не який це плагін, тож запис у такій формі ніколи не зміг би нічого вибрати. Запис, що називає функцію входу через function: без uri:, теж повідомляється тут, якщо це запис plugins.linter чи linter_append або запис plugins.governance чи governance_append у ролі вердикту, ir-verdict або render-verdict: ці підключення вибирають свій плагін за uri, тож такий запис не підключає жодного плагіна, і функцію, яку він називає, ніколи не було б викликано — лінт працював би далі так, ніби запису немає, а збірка зупинилася б лише пізніше, коли дійшла б до розв’язання плагіна, якого запис так і не назвав.

Каталог каталогу, який перелічує конфігурація, — у workspace.catalog_dirs чи catalog_dirs_append або у власному записі сутності Release у workspace.releases, у будь-якому файлі, з якого читається конфігурація, — також повідомляється тут, коли він не є каталогом: за цим шляхом нічого не існує або там є файл чи посилання, що веде в нікуди. Це оцінюється тоді, коли через нього має бути прочитано каталог сутностей, тож кожна команда, що читає каталог, відхиляє його, перш ніж щось прочитати чи записати, а команда, яка не читає каталогу, і далі працює. Читання далі без нього означало б збирання з меншою кількістю каталогів, ніж ви перелічили, і ніщо не вказувало б, яких саме бракує. Каталог, перелічений у AGGREGA_CATALOG_DIRS, підлягає тому самому правилу, а відмова називає змінну замість файлу.

Хост реєстру — host запису registries або хост, з якого починається default_registry, якщо це значення не називає один із цих записів за його name: (у такому разі воно позначає хост цього запису), — записується як сам хост: малими літерами, з крапкою, або localhost, або одне ім’я з портом, або IP-адреса (IPv6 — у квадратних дужках), кожен варіант із необов’язковим :port, без схеми й облікових даних. Хост запису registries не містить шляху; default_registry може продовжувати свій хост символом / і шляхом репозиторію — сегментами малими літерами, з’єднаними через /, без тегу, дайджесту чи кінцевого /. Значення, що називає хост в іншому написанні, відхиляється з указанням написання, яке слід використати (для default_registry — усього розташування разом зі шляхом), щоб до нього застосовувалася політика довіри, збережена для цього хоста; це стосується й порту 443 на хості, доступному через HTTPS, оскільки це стандартний порт цього хоста. Шлях, що не є шляхом репозиторію, відхиляється з указанням хоста, за яким він іде, а name: запису, за яким іде шлях, відхиляється з указанням двох написань, які слід використати натомість: лише ім’я або хост запису, за яким іде шлях, оскільки ім’я позначає хост свого запису, а не розташування під ним. Значення, що не називає жодного хоста — одне ім’я без порту, якого не має жоден запис, або текст із пробілами чи фігурними дужками, — відхиляється як не хост, а для default_registry у відмові зазначено, що ім’я запису також підійде. AGGREGA_DEFAULT_REGISTRY перевіряється за тими самими правилами й відхиляється так само, з указанням змінної.

Повідомлення, що виводяться. Заперечення схеми називає файл, шлях поля і те, що сказала схема:

workspaceconfig: <path>: <field-path>: <the schema's own objection>: workspace configuration is invalid (workspaceconfig: конфігурація робочого простору недійсна)

Форми з підказкою виправлення починаються з файлу й замість шляху поля та заперечення схеми містять речення про конкретну форму. artifact_cache_dir, що називає корінь робочого простору:

<path>: artifact_cache_dir "<value>" names the workspace root itself; a catalog directory at the workspace root would then be stepped over as cache, leaving nothing to load — give the cache its own subdirectory (for example .aggrega/cache): workspace configuration is invalid (artifact_cache_dir називає сам корінь робочого простору; тоді каталог каталогу в корені робочого простору було б пропущено як кеш і нічого не залишилося б для завантаження — виділіть кешу власний підкаталог (наприклад, .aggrega/cache): конфігурація робочого простору недійсна)

непридатний запис signing.kinds, що також називає символ узагальнення, який охоплює всі види:

<path>: signing.kinds entry "<kind>" is not a signable artifact kind; use a catalog entity or plugin kind, or "all" for every kind: workspace configuration is invalid (запис signing.kinds не є видом артефакту, який можна підписати; використайте вид сутності каталогу чи плагіна або “all” для всіх видів: конфігурація робочого простору недійсна)

прив’язка провайдера, записана як розташування в реєстрі, що називає запис, можливість і форму, яку слід написати:

<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 (запис plugins.providers прив’язує можливість до розташування в реєстрі, яке вказує, де плагін опубліковано, а не який це плагін; прив’язка провайдера називає свій плагін за його ідентичністю — запишіть в uri ідентичність плагіна з необов’язковою версією: конфігурація робочого простору недійсна)

підключення лінтера або підключення управління в ролі вердикту, що називає функцію входу, але не плагін, — повідомлення називає список, запис і функцію, тут на 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 (запис plugins.linter називає функцію входу, але не URI плагіна; підключення в цьому списку вибирає свій плагін за URI, тож цей запис не підключає жодного плагіна, і функцію ніколи не буде викликано — додайте URI плагіна, який її експортує: конфігурація робочого простору недійсна)

хост реєстру, записаний в іншому написанні, тут HUB.AGGREGA.AI:

<path>: default_registry "HUB.AGGREGA.AI" is not written as the registry host it names; write "hub.aggrega.ai" — lowercase, with no scheme, path, credentials or default port — which is the spelling that host’s trust policy is kept under: workspace configuration is invalid (default_registry “HUB.AGGREGA.AI” записано не так, як хост реєстру, який він називає; напишіть “hub.aggrega.ai” — малими літерами, без схеми, шляху, облікових даних чи порту за замовчуванням, — це написання, під яким збережено політику довіри цього хоста: конфігурація робочого простору недійсна)

реєстр за замовчуванням, хост якого перед шляхом репозиторію записано в іншому написанні, тут GHCR.io/acme, з указанням усього розташування, яке слід написати:

<path>: default_registry "GHCR.io/acme" is not written as the registry location it names; write "ghcr.io/acme" — the registry host lowercase, with no scheme, credentials or default port, followed by the repository path — which keeps that host’s trust policy applying to it: workspace configuration is invalid (default_registry “GHCR.io/acme” записано не так, як розташування реєстру, яке він називає; напишіть “ghcr.io/acme” — хост реєстру малими літерами, без схеми, облікових даних чи порту за замовчуванням, а за ним шлях репозиторію, — щоб до нього й надалі застосовувалася політика довіри цього хоста: конфігурація робочого простору недійсна)

ім’я запису, за яким іде шлях, тут local/acme, де запис з іменем local відповідає 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 “local/acme” — це ім’я запису registries “local”, за яким іде шлях, а ім’я запису означає лише хост цього запису; напишіть “local”, щоб використати запис, або його хост зі шляхом, “127.0.0.1:5000/acme”: конфігурація робочого простору недійсна)

значення, що не називає хоста, речення якого перелічує форми хоста:

<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 не є хостом реєстру; запишіть ім’я хоста малими літерами з крапкою (registry.example.com), localhost, одне ім’я з портом (registry:5000) або IP-адресу, IPv6 — у квадратних дужках, — кожен варіант із необов’язковим :port і нічим іншим: конфігурація робочого простору недійсна)

перелічений каталог каталогу, за яким нічого не існує; повідомлення називає файл і рядок, список, запис у написаному вигляді та шлях, у який його розв’язано, — списком є workspace.catalog_dirs, workspace.catalog_dirs_append або список запису сутності Release, наприклад `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 (каталог, названий записом, не існує; створіть цей каталог або видаліть запис: конфігурація робочого простору недійсна)

і порожній маркер workspace::

workspaceconfig: <path>: workspace must be a mapping; write workspace: {} to mark a workspace root with no catalog directories: workspace configuration is invalid (workspaceconfig: workspace має бути зіставленням; напишіть workspace: {}, щоб позначити корінь робочого простору без каталогів: конфігурація робочого простору недійсна)

Ще два називають ключ, написаний не на своєму місці: default_registry, offline, auto_pull і artifact_cache_dir розташовані на верхньому рівні, а не під workspace:, а блок кешу розбору — це parse_cache:. Кожне з них указує, який ключ мається на увазі і де йому місце.

Як виправити: відкрийте файл, названий у повідомленні, і перейдіть до наведеного шляху поля. Якщо повідомлення містить речення з підказкою виправлення, воно прямо називає правильне написання чи розташування, і нічого більше читати не потрібно. Якщо натомість воно містить заперечення схеми, шлях поля — це хибний ключ, а заперечення пояснює, чого схема там очікувала; сторінки сутностей цим файлом не керують, тож читайте заперечення, а не шукайте контракт сутності. artifact_cache_dir записується відносно кореня робочого простору й потребує власного підкаталогу, щоб каталог у корені робочого простору не було помилково сприйнято як кеш і пропущено. Прив’язку провайдера, записану як розташування в реєстрі, переписують вручну на ідентичність плагіна — oci://hub.aggrega.ai/plugin/provider/compose стає provider/compose, — бо доки цього не зроблено, її відхиляє кожна команда, що читає файл, зокрема aggrega plugin remove; aggrega plugin add provider сама записує форму з ідентичністю. Запис лінтера або запис управління в ролі вердикту, що називає функцію, але не плагін, отримує uri плагіна, який експортує цю функцію; якщо такого немає, видаліть запис — у списку лінтерів тоді працює стандартний лінтер, так само як без налаштованого лінтера. Перелічений каталог каталогу, який не є каталогом, створюють за шляхом, названим у відмові, або видаляють його запис із рядка, названого у відмові; у копії проєкту, взятій без сусідньої робочої копії, яку він перелічує, цей запис видаляють.

A plugin binding sets a key the socket it attaches to does not read (Прив’язка плагіна задає ключ, який не читає сокет, до якого вона під’єднується)

Сокети в конфігурації робочого простору під’єднують плагіни двома різними способами, і ключ, що належить одному способу, нічого не означає для іншого. Замість того щоб прийняти ключ і мовчки його проігнорувати, конфігурація відхиляється, тож оператор дізнається, що параметр не діє, а не з’ясовує згодом, чому він не мав ефекту.

Ці дві невідповідності є дзеркальними відображеннями одна одної.

  • Наскрізний сокет, прив’язаний за можливістю. Сокети governance, linter та importer під’єднують плагін безпосередньо через uri:. Плагін governance або linter не обслуговує жодної можливості, тож прив’язку capability: там шукали б серед нічого, і вона нічому б не відповідала — це під’єднання, яке ніколи не може розв’язатися. Імпортер справді оголошує формати, які обробляє, але який формат потрібен, визначає імпорт, а не під’єднання: під’єднання імпортера називає свій імпортер через uri:, і саме це обирає його серед імпортерів, що оголошують формат, якого вимагає імпорт.
  • Сокет провайдера задає ключ без референта. Прив’язка провайдера називає можливість і плагін, що її обслуговує, а плагін керує фіксованим набором експортів, а не однією вибірною точкою входу, тож function: нічого в ньому не називає. with: відхиляється з іншої причини: конфігурацію рендерингу для провайдера пишуть у Recipe, тож розміщення її в прив’язці робочого простору ставить її не на той бік розподілу між розробником та оператором.

Повідомлення, що виводяться. Можливість на наскрізному сокеті:

workspaceconfig: the <socket> socket is bound by capability "<capability>", but the cross-cutting sockets attach by uri: their plugin serves no capability, so a capability lookup matches nothing; attach it with uri: instead: a cross-cutting socket is bound by capability but attaches by uri (workspaceconfig: сокет <socket> прив’язано за можливістю “<capability>”, але наскрізні сокети приєднують за uri: їхній плагін не обслуговує жодної можливості, тож пошук за можливістю нічого не знаходить; натомість приєднайте його через uri:: наскрізний сокет прив’язано за можливістю, але він приєднує за uri)

недійовий function: у прив’язці провайдера:

workspaceconfig: the provider socket binding for capability "<capability>" sets function:, but a provider drives a fixed set of phase-keyed exports rather than one selectable entry, so function: names nothing there; remove it: a provider socket binding sets a field with no referent on that socket (workspaceconfig: прив’язка сокета провайдера для можливості “<capability>” задає function:, але провайдер керує фіксованим набором експортів за фазами, а не однією вибірною точкою входу, тож function: там нічого не позначає; видаліть його: прив’язка сокета провайдера задає поле, яке на цьому сокеті ні на що не посилається)

і недійовий with:, про який повідомляється в тій самій формі з указанням, де натомість має бути конфігурація:

workspaceconfig: the provider socket binding for capability "<capability>" sets with:, but provider render configuration belongs in the Recipe, not the workspace provider binding; remove it: a provider socket binding sets a field with no referent on that socket (workspaceconfig: прив’язка сокета провайдера для можливості “<capability>” задає with:, але конфігурація рендерингу провайдера належить до Recipe, а не до прив’язки провайдера в робочому просторі; видаліть його: прив’язка сокета провайдера задає поле, яке на цьому сокеті ні на що не посилається)

function:, записаний у .aggrega-config.yaml, не доходить до наведеного вище речення: схема конфігурації робочого простору не оголошує такого ключа в прив’язці провайдера, тож файл відхиляється раніше, під E0224, а рішення те саме — видаліть ключ:

workspaceconfig: <file>: plugins.providers[<index>].function: against /$defs/FixedEntryPluginRef: unexpected property: “function”: workspace configuration is invalid (workspaceconfig: function запису plugins.providers: щодо /$defs/FixedEntryPluginRef: неочікувана властивість “function”: конфігурація робочого простору недійсна)

Як виправити: виправлення робиться в .aggrega-config.yaml, і кожне повідомлення називає точну правку. У під’єднанні governance, linter або importer замініть capability: на uri: плагіна, який ви мали намір під’єднати. У прив’язці провайдера видаліть названий ключ — а якщо це був with:, перенесіть цю конфігурацію в Recipe, що рендерить через провайдер, адже саме він її читає.

A capability is bound to more than one provider plugin (Можливість прив’язано більш ніж до одного плагіна провайдера)

Можливість називає один спосіб перетворення робочого навантаження на артефакти, і в розв’язаному робочому просторі її обслуговує рівно один плагін. Дві прив’язки для однієї можливості не дають відповіді, яка з них рендерить, а конфігурація робочого простору збирається з кількох шарів — спільного файлу, файлу робочого простору та додаткових файлів-доповнень, які може внести кожен із них, — тож другу прив’язку часто вносить шар, автор якого не міг бачити першої.

Саме відмова робить це видимим. Якби одна прив’язка мовчки перемагала, результат рендерингу залежав би від того, який шар випадково прочитано останнім.

Повідомлення, що виводиться, з назвою можливості та правила:

workspaceconfig: capability "<capability>" is bound to more than one provider plugin; keep exactly one plugins.providers entry per capability: capability is bound to more than one provider plugin (workspaceconfig: можливість “<capability>” прив’язано до більш ніж одного плагіна провайдера; залиште рівно один запис plugins.providers на можливість: можливість прив’язано до більш ніж одного плагіна провайдера)

Як виправити: залиште один запис plugins.providers для можливості, яку називає повідомлення, а інший видаліть. Якщо обидва походять з різних шарів конфігурації, редагувати слід шар, який контролюєте ви: видалення власного запису приймає запис спільного шару, а збереження вашого означає, що натомість має зникнути запис спільного шару. Два плагіни, що справді обидва обслуговують робочий простір, обслуговують дві різні можливості, тож якщо потрібні обидва, дайте кожному власну можливість, а не прив’язуйте одну двічі.

An importer is attached by more than one plugins.importer entry (Імпортер під’єднано більш ніж одним записом plugins.importer)

Запис plugins.importer під’єднує імпортер, який називає його uri: якщо цей імпортер оголошує формат, якого вимагає імпорт, запис визначає, яка його версія запускається, і передає йому with.sources та with.settings запису. Один запис робить це для одного імпортера, тож другий запис, що називає той самий імпортер — ту саму ідентичність, тієї самої чи іншої версії, — ніхто б не читав, і його with не дійшов би до жодного імпортера без жодного попередження. Натомість конфігурація відхиляється під час завантаження, хоч яка команда її читає.

Конфігурація робочого простору збирається з кількох файлів — глобального файлу, кожного .aggrega-config.yaml від кореня проєкту до каталогу, у якому запускається команда, доповнення importer_append, яке може мати кожен із них, і файлу конвеєра .aggrega-config-append-ci.yaml, — тож другий запис часто написано в іншому файлі, ніж перший. Повідомлення називає імпортер і обидва записи, спершу ранніший, кожен — за ключем і позицією, під якими його написано, файлом, у якому його написано, та його uri у тому вигляді, як він там записаний.

Перевіряється лише список імпортерів: списки governance і linter допускають один плагін, під’єднаний кілька разів, причому кожне під’єднання має власний with. Запис, чий uri є шляхом у файловій системі, не називає жодного імпортера, тож його не порівнюють.

Повідомлення, що виводиться:

importer "<identity>" is attached by <key>[<position>] in <file> (uri "<uri>") and again by <key>[<position>] in <file> (uri "<uri>"); keep exactly one plugins.importer entry per importer, its uri naming the version you want: importer is attached by more than one plugins.importer entry (імпортер “<identity>” приєднано через <key>[<position>] у <file> (uri “<uri>”) і повторно через <key>[<position>] у <file> (uri “<uri>”); залиште рівно один запис plugins.importer на імпортер, uri якого вказує потрібну вам версію: імпортер приєднано більш ніж одним записом plugins.importer)

Як виправити: залиште один запис для імпортера, якого називає повідомлення, — той, чий uri називає потрібну вам версію і який містить with, що його ви хочете передати імпортеру, — а інший видаліть. Якщо записи в різних файлах, редагувати слід файл, який контролюєте ви: видалення вашого запису приймає запис іншого файлу, а збереження вашого означає, що натомість має зникнути запис іншого файлу.

A provider binding names a capability containing a colon (Прив’язка провайдера називає можливість, що містить двокрапку)

capability: у Recipe читається як назва можливості до останньої двокрапки та закріплення версії після неї — helm:1.0.0 запитує можливість helm версії 1.0.0. Запис plugins.providers шукається за цією назвою, тож можливість, яку називає прив’язка, ніколи не містить двокрапки, а запис, чия можливість її містить, недосяжний для жодного Recipe. Замість того щоб дозволити йому лишатися в конфігурації непрочитаним, конфігурація відхиляється під час завантаження, хоч яка команда її прочитала.

Перевіряється лише список провайдерів. Список імпортерів має таку саму форму запису, але його плагіни під’єднуються через uri: і називають свої формати import:<format>, де двокрапка є частиною назви. uri: прив’язки все одно може закінчуватися на :<version>; це не та частина, яку читає це правило.

Повідомлення, що виводиться, з назвою можливості:

the provider socket binding for capability "<capability>": a Recipe’s capability reference is read as the capability up to its last colon and a version pin after it, so the capability a binding names carries no colon; bind the capability name alone and let each Recipe pin the version it needs: a provider socket binding names a capability containing a colon, which no Recipe can select (прив’язка сокета провайдера для можливості “<capability>”: посилання на можливість у Recipe читається як можливість до останньої двокрапки і закріплена версія після неї, тож можливість, яку називає прив’язка, не містить двокрапки; прив’яжіть лише назву можливості, а кожен Recipe нехай закріплює потрібну йому версію: прив’язка сокета провайдера називає можливість із двокрапкою, яку жоден Recipe не може вибрати)

Як виправити: запишіть у записі лише назву можливості — capability: helm — і закріплюйте версії там, де їм місце: Recipe закріплює потрібну йому версію провайдера у власному capability:, а прив’язка, яка має вибрати певну версію свого плагіна, записує її в ідентичності плагіна, uri: provider/helm:1.0.0.

A governance attachment declares no role, or one that is not a known role (Підключення governance не оголошує ролі або оголошує невідому роль)

Підключення governance має роль, і саме роль, а не власний оголошений тип плагіна, визначає, де виконується підключення і що воно може робити: чи приймає воно збірку або відхиляє її, і чи читає воно граф або відрендерені артефакти. Підключення розподіляються за цією роллю, тож підключення без ролі або з роллю, яку ніхто не розпізнає, ні до чого не приєдналося б і було б мовчки пропущене.

Саме цій тиші запобігає відмова. Плагін governance, який налаштовано, але ніколи не викликано, дає точно такий самий результат, як збірка, що ніколи не проходила governance, і ніщо в результаті не вказує, яку з них ви маєте.

Повідомлення, що виводяться; обидва називають підключення й перелічують наявні ролі. Відсутня роль:

workspaceconfig: governance attachment "<uri>" declares no role; set role: to one of <the known roles>: a governance attachment declares no role or an unknown role (workspaceconfig: вкладення governance не оголошує ролі; задайте для role: одну з відомих ролей: вкладення governance не оголошує ролі або оголошує невідому роль)

і нерозпізнана роль:

workspaceconfig: governance attachment "<uri>" declares unknown role "<role>"; use one of <the known roles>: a governance attachment declares no role or an unknown role (workspaceconfig: вкладення governance оголошує невідому роль; використайте одну з відомих ролей: вкладення governance не оголошує ролі або оголошує невідому роль)

Як виправити: встановіть role: у підключенні в plugins.governance в одну з ролей, які перелічує повідомлення. Яку саме — це рішення про те, що ви хочете від плагіна, а не про сам плагін: роль, що приймає або відхиляє, читає збірку й повертає вердикт, а роль, що перетворює, — це явна вказівка дозволити плагіну змінювати те, що він отримує. Повідомлення перелічує повний набір, тож правильне написання є в самому повідомленні.

A registry alias matches more than one host (Псевдонім реєстру відповідає більш ніж одному хосту)

Реєстру можна дати короткий псевдонім у конфігурації робочого простору, щоб команди й посилання могли називати його, не виписуючи хост. Псевдонім вибирає рівно один хост. Ця умова повідомляє про токен, що відповідає псевдоніму двох записів реєстру: невідомо, який хост малося на увазі, а вибір одного з них мовчки надіслав би артефакти до реєстру, якого автор не називав, або отримав би їх звідти.

Повідомлення, що виводиться, називає псевдонім, кількість записів, які його заявили, і їхні хости:

registry alias "<alias>" matches <count> hosts (<hosts>); address the registry by host or remove the duplicate alias: registry alias matches more than one host (псевдонім реєстру відповідає кільком хостам; звертайтеся до реєстру за хостом або видаліть дубльований псевдонім: псевдонім реєстру відповідає більш ніж одному хосту)

Як виправити: відкрийте .aggrega-config.yaml і призначте псевдонім одному з хостів, які перелічує повідомлення, або звертайтеся до реєстру за його хостом і приберіть псевдонім із посилання. Повідомлення називає кожен хост, що має цей псевдонім, тож які записи переглянути, вказано в повідомленні. Якщо записи походять з різних шарів конфігурації, редагуйте шар, яким володієте ви.

The lockfile does not satisfy its schema (Lockfile не відповідає своїй схемі)

Lockfile релізу фіксує, до чого розв’язалася збірка: для кожної сутності, бібліотеки й плагіна, яких вона досягає, — вибрану версію та дайджест байтів цієї версії. Його читають і перевіряють за схемою, перш ніж перетворити на типізовані закріплення, тож документ, що не відповідає схемі, відхиляється із зазначенням шляху поля, на якому сталася помилка, замість того щоб мовчки створити закріплення з прогалинами.

Lockfile записується машиною. Його створює pull, що розв’язує реліз, і його комітять, щоб та сама збірка й пізніше розв’язувалася так само. Тому помилка схеми майже завжди означає ручне редагування, злиття, що залишило документ напіврозв’язаним, або lockfile, записаний для попередньої форми файлу — наприклад, такий, у якого entities не мають kind, — а не щось навмисно написане.

Відсутній lockfile — це інша умова, і про неї повідомляється інакше: lockfile обов’язковий, тож про його відсутність повідомляється там, де збірка його шукає, з вказівкою виконати pull, що його створює.

Повідомлення, що виводиться, називає файл, шлях поля та власне заперечення схеми:

lockfile: <path>: <field-path>: <the schema's own objection>: lockfile: file failed schema validation (lockfile: файл не пройшов перевірку за схемою)

Збірка, а також aggrega pull --verify, додають команду, яка знову записує lockfile:

…: lockfile: file failed schema validation; run aggrega pull --release <release> to write it again from the Release (lockfile: файл не пройшов перевірку схеми; виконайте команду, щоб знову записати його на основі сутності Release)

Про повністю порожній документ повідомляється окремо, оскільки немає поля, яке можна назвати:

lockfile: <path>: document is empty (lockfile: документ порожній)

Як виправити: не виправляйте lockfile вручну. Повторно виконайте pull для релізу, який перезапише документ на основі виконаного розв’язання, і закомітьте результат: саме повторне розв’язання дає документ, закріплення якого відповідають тому, чого реліз справді досягає. Якщо збій стався після злиття, розв’язання конфлікту повторним pull, а не редагуванням, дозволяє уникнути документа, який розбирається, але закріплює неправильні версії. Шлях поля в повідомленні варто прочитати першим: він показує, чи пошкодження в одному записі, чи в загальній структурі документа.

Під час розв’язання каталогу

Після завантаження компілятор проходить двома рівнями Manifest (спочатку мапа типів, потім мапа імен), щоб вибрати Recipe для кожного Component, і проходить усі ланцюжки extends у сутностях Manifests, Components або Features. Власний ланцюжок extends сутності Release обробляється тим самим проходом, на крок раніше: його відстежують під час розв’язання Release, ще до пошуку Manifest чи Aggregate, які він називає, тому описані нижче умови повідомляються щодо Release, а не щодо сусіднього вказівника, який мав надати ланцюжок.

Cyclic extends chain (Циклічний ланцюжок extends)

Ланцюжок вказівників extends замикається сам на себе. Кожен вид, що оголошує extends, — Component, Feature, Manifest і Release — обробляється одним проходом ланцюжка, тому цикл повідомляється однаковими словами, де б його не виявили.

Повідомлення, що виводиться. Воно починається реченням, що називає умову, далі йдуть сутність, з якої почалося розв’язання, і правило, що його відхилило, а потім ребро, яке замикає цикл, — сутність із проблемним extends: і посилання, яке вона оголошує:

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 (циклічний ланцюжок extends: сутність уже є в ланцюжку; приберіть extends або спрямуйте його на сутність поза ланцюжком)

Сутність, названа першою, і сутність, названа в ребрі, зазвичай різні, і саме в цьому суть: цикл повідомляється щодо кожної сутності в ньому, а рядок extends:, який слід редагувати, — той, що його називає ребро. Дивіться на ребро, а не на заголовок.

Для Manifest <kind> має значення Manifest, кожну сутність названо за її metadata.name, а <reference> — це значення extends: точно так, як його записано: відносний шлях, наприклад ./base.yaml, або просте metadata.name маніфесту поруч із Release. Яку з двох форм ви записали, не змінює повідомлення: ланка Manifest — це файл, до якого вона розв’язується, тому два файли Manifest, що випадково оголошують одне metadata.name, є двома ланками, і ланцюжок через обидва не є циклом.

Release читається так само, і тут ідентичність файлу важить більше, бо форма, яку вона захищає, звичайна: <kind> має значення Release, <reference> — це відносний шлях, який називає extends:, а ланка Release — це файл, до якого вона розв’язується. Два файли Release, що називають розгорнуту систему, а не середовище, — обидва з metadata.name: shared-release, один розширює інший, — є двома ланками, і ланцюжок через обидва не є циклом.

Цикл повідомляється як цикл, хоч якої він довжини. Обхід ланцюжка застосовує обмеження глибини лише до ланцюжка, що закінчується, тож цикл, який охоплює більше сутностей, ніж дозволяє обмеження, однаково повідомляється тут, а не як надто глибокий ланцюжок: цикл ніколи не виправляють його скороченням.

Як виправити: відкрийте сутність, яку називає ребро, і або видаліть її extends:, або спрямуйте його на сутність, якої ще немає в ланцюжку. Якщо кілька рівнів мали спільно використовувати вміст, згортання дубльованого вмісту в одну базову сутність усуває і цикл, і дублювання.

Recipe implements does not match the mapped component type (implements у Recipe не відповідає зіставленому типу компонента)

Запис зіставлення в Manifest вказує на Recipe, чиє оголошення spec.implements: не відповідає ключу типу компонента для цього запису. spec.implements — це якір узгодженості, а не механізм диспетчеризації: значення зіставлення прямо називає Recipe, а ця перевірка підтверджує, що названий автором Recipe оголошує саме той тип, який автор зіставив.

Перевірка читає скомпонований Manifest до розв’язання будь-якого Recipe, тож повідомляє про запис зіставлення, написаний автором, а не про його подальший симптом.

Повідомлення, що виводиться:

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 рецепта в записі зіставлення маніфесту не збігається із зіставленим ключем типу компонента / типу функції)

Цю перевірку виконує кожна команда, що читає залежності Release; різниться лише те, що кожна робить із результатом. aggrega build і aggrega pull зупиняються, бо обидві створюють те, чим ви користуватиметеся далі, — згенеровані артефакти та lockfile. aggrega validate і aggrega lint повідомляють цю знахідку разом з усією іншою діагностикою, яку знайшли, а потім завершуються з ненульовим кодом: їхнє завдання — повідомити все, що не так із робочим простором, тому одна помилка не обриває звіт. У редакторі знахідку публікують як діагностику поруч з іншими, і все інше, що мав повідомити документ, не зачіпається. Зверніть увагу, де вона з’являється: редактор публікує знахідку в сутності Manifest, у якій записано зіставлення, на ключі запису зіставлення, який вона називає, а не в Aggregate, — на першому рядку сутності Manifest, якщо її відкритий текст не містить цього запису, як-от для запису, успадкованого через extends. Інша діагностика рівня залежностей Release, яка не називає жодного документа вашого робочого простору, залишається в Aggregate. Запуск aggrega validate повідомляє її незалежно від того, який документ відкрито.

Запис зіставлення, що називає Recipe, якого немає в каталозі, — це не ця умова: перевірці немає з чим порівнювати, тож вона пропускає запис, а про нерозв’язний Recipe повідомляється під час розв’язання рецептів.

Записи FeatureRecipe мають таку саму форму; перевірка зіставлення features.type виводить manifest feature mapping ... featurerecipe spec.implements is ... (expected ...), а гілка функцій звіряє сам ключ зіставлення, тому не називає альтернативи через extends.

Ключ components.type оцінюється також для кожного екземпляра, щойно він доходить до екземпляра іншої версії. Ключ, що не називає точний тип екземпляра, доходить до нього через базу типу, коли жоден ключ не називає цей точний тип і для тієї самої бази не записано іншого ключа, — тож до нього може дійти ключ, записаний без версії, або ключ, що називає іншу версію. Отже, сам запис не може сказати, чи підходить його Recipe, і збірка знову оцінює Recipe для кожного екземпляра компонента, до якого ключ доходить у такий спосіб, ставлячи на місце ключа власний тип екземпляра у версії, в якій збірка його компілює: версію, яку називає екземпляр, або, для екземпляра без версії, найвищу версію цієї сутності Component у каталозі. Екземпляр, версії якого не задовольняє spec.implements: сутності Recipe — ні точно, ні за діапазоном caret, ні як неверсійований, ні через базу, яку extends тип екземпляра, — спричиняє цю умову, про яку повідомляється за шляхом .spec.components.<instance> екземпляра, а не у файлі 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 рецепта із запису зіставлення Manifest не збігається зі зіставленим ключем типу компонента чи типу функції (Manifest; тип екземпляра й версія компіляції, ключ зіставлення, через який його досягнуто, зіставлений рецепт і його spec.implements). зіставте цей тип у цій версії з рецептом, що його реалізує, за допомогою ключа зіставлення, який називає версію)

Значення compiled as з’являється лише для екземпляра, тип якого не називає версії; екземпляр, що називає версію, показує її в of type. Ключ, що називає власну версію екземпляра, не потребує другої оцінки, бо перевірка запису вже її виконала, а про запис, уже відхилений за своїм ключем, повідомляється один раз, як вище, а не ще раз для кожного екземпляра. aggrega build і aggrega pull на цьому зупиняються, а aggrega validate --release повідомляє про це й завершується з ненульовим кодом. aggrega lint оцінює записи зіставлення Manifest, а не екземпляри, до яких вони доходять, тож про це не повідомляє.

Як виправити: або виправте оголошення spec.implements: у Recipe, щоб воно збігалося з ключем типу компонента в Manifest, або змініть запис Manifest, щоб він вказував на Recipe, чиє spec.implements: збігається з ключем типу компонента. Для екземпляра, до якого ключ доходить в іншій версії, додайте ключ зіставлення, що називає версію екземпляра й зіставлений із сутністю Recipe, яка його реалізує, або спрямуйте ключ, що доходить, на таку сутність Recipe.

Manifest mapping value is not a shape a recipe reference accepts (Значення зіставлення в Manifest має форму, якої не допускає посилання на рецепт)

Значення зіставлення в Manifest називає Recipe або FeatureRecipe у формі, яку граматика посилань не може виразити. Посилання на рецепт допускає просте ім’я, ім’я з версією, ім’я з кваліфікатором можливості або ім’я з кваліфікатором можливості та версією — щонайбільше один /. Значення, що містить більше (шлях у стилі типу компонента, як-от core/helm/eso-aws-fetcher:1.0.0), ніколи не може назвати сутність каталогу, хоч що б містив каталог.

Форму оцінюють під час компонування Manifest, ще до будь-якого пошуку: вердикт випливає з підрахунку роздільників у рядку, тож каталог узагалі не потрібен. Саме оцінка на цьому етапі робить діагностику чесною: рецепт, який значення мало на увазі, часто присутній і правильно названий, а повідомлення про його відсутність змусило б вас шукати не те. Кожна команда, що розв’язує залежності Release, повідомляє про це однаково, тож результат не залежить від того, яку з них ви запустили.

Повідомлення, що виводиться:

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 (некоректне посилання на рецепт у значенні зіставлення Manifest: spec.mappings.components.type.<key> зіставляється з <value>, що містить <n> сегментів, розділених скісною рискою; посилання на рецепт допускає “name”, “name:version”, “capability/name” або “capability/name:version”; виправте значення зіставлення в Manifest)

Розділ features виводить те саме повідомлення щодо власної координати, а посилання на рецепт функції називається відповідно.

Значення, сегмент можливості якого містить закріплення версії, — compose:1.2.3/svc:1.0.0, — відхиляється так само, до будь-якого пошуку, тож із реєстру нічого не отримується. Закріплення належить до capability, яку оголошує Recipe, де воно вибирає, яка версія плагіна, що обслуговує цю можливість, виконує рендеринг; посилання називає Recipe за голою можливістю (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 (некоректне посилання на рецепт у значенні зіставлення Manifest: значення цього ключа містить закріплення версії в сегменті можливості; закріплення належить до capability, яку оголошує рецепт, а посилання на рецепт називає рецепт за голою можливістю; виправте значення зіставлення в Manifest)

Як виправити: скоротіть значення зіставлення до форми, яку допускає граматика. Рецепт ідентифікується власним metadata.name — за потреби з префіксом spec.capability і суфіксом версії, — і ніколи шляхом типу компонента, який він реалізує. Ключ зіставлення — це тип компонента; значення зіставлення — це рецепт.

Не плутайте з коректно сформованим значенням, що називає рецепт, якого немає в каталозі: це справді відсутня сутність, і про неї повідомляється саме так, із зазначенням URI та запису зіставлення, що на неї посилався.

Кілька сутностей Recipes реалізують один тип Component

Дві або більше сутностей Recipes оголошують той самий тип Component у spec.implements: — дві сутності Recipes з точною версією для одного типу або сутність Recipe без версії поруч із закріпленою.

Це не спричиняє окремої зупинки й не є неоднозначністю, яку збірка має розв’язувати. Вибір Recipe відбувається лише через зіставлення: ніщо не читає spec.implements: і не обирає серед кандидатів, тож хоч скільки сутностей Recipes реалізують тип, екземпляр рендерить той Recipe, на який його зіставляє Manifest. Поле spec.implements: читається як якір узгодженості — воно підтверджує, що Recipe, який зіставив автор, оголошує тип, під яким автор його зіставив, — і як джерело кандидатів на закріплення, які пропонує зупинка. Воно ніколи нічого не обирає.

Натомість ви побачите зупинку для екземпляра, який Manifest ні на що не відображає, і ця зупинка перелічує кожну Recipe, що реалізує тип, щоб ви могли закріпити одну, — див. «No Recipe is mapped for a component or feature instance (Для екземпляра компонента чи функції не відображено жодної Recipe)» нижче. Вона звітує однаково, чи тип реалізує одна сутність Recipe, чи п’ять, тому окремої умови неоднозначності, яку варто шукати, немає.

Як виправити: додайте відображення. Запис за типом маршрутизує кожен екземпляр типу; запис за ім’ям маршрутизує один іменований екземпляр і читається першим, тож так само можна призначити одному екземпляру іншу Recipe, ніж його сусідам.

Divergent Release (extends + aggregate pointer) (Розбіжна Release: extends + вказівник aggregate)

Сутність Release використовує extends:, щоб успадкувати базовий Release, але водночас оголошує власний вказівник aggregate:. JSON Schema сутності Release відхиляє таку форму під час валідації схеми (рівень 1, перевірка оболонки) через обмеження allOf: коли присутнє extends:, поле aggregate: заборонене; коли extends: відсутнє, обов’язкові і aggregate:, і manifest:.

Зупинка відбувається як звичайне порушення оболонки, тож діагностика має форму цього класу — див. «The document-envelope failure class» у error-translation.md — а знахідка вказує на ключ, який тут не дозволено:

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 (валідація оболонки документа не вдалася (Release, у <path>); <line>:<column>: spec.aggregate: значення відповідає формі, яку тут не дозволено. виправте документ відповідно до схеми його типу)

Як виправити: вилучіть поле aggregate: з дочірньої Release. Успадкування навмисно змушує дочірню сутність розгортати той самий Developer Intent, що й батьківська; якщо потрібно розгорнути інший Aggregate, створіть нову Release без extends:.

A feature attached by both the Aggregate and the Release cannot be merged (Функцію, підключену і в Aggregate, і в Release, неможливо об’єднати)

Коли локальний Manifest extends базовий Manifest, два рівні (мапа type:, мапа name:) зливаються незалежно. У межах кожного рівня дочірні ключі перезаписують батьківські на верхньому рівні — це поверхнева заміна, а не глибоке злиття. Дочірній запис для певного ключа повністю замінює батьківський запис для цього ключа.

Коли те саме ім’я екземпляра функції з’являється і на боці Aggregate, і на боці Release з конфліктним станом, що не зливається (поза дозволеним нашаруванням infra), компілятор зупиняється й прив’язує діагностику до приєднання, яке не зміг узгодити. Дві конфліктні декларації йдуть у фіксованому порядку — спершу тип, оголошений в Aggregate, потім тип, оголошений у Release, — тож можна зрозуміти, який документ що сказав, не відкриваючи обидва.

Повідомлення, що виводиться:

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>") (конфлікт злиття функції: узгодьте оголошення функції в Aggregate і Release (тип, оголошений в Aggregate, і тип, оголошений у Release))

Те саме стосується приєднання, яке несе з’єднання. Коли запис з’єднання в Aggregate і запис того самого з’єднання в Release обидва записують приєднання під одним слотом і називають різні сутності Features, збірка після сплощення композиції зупиняється на записі Release — там, де записано другий тип, — називаючи обидва типи, слот, з’єднання, сокет і компонент:

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. (конфлікт злиття функції: узгодьте оголошення функції в Aggregate і Release — для зазначених Release, шляху, типів, слота, з’єднання, сокета й компонента. Приберіть тип із запису Release, щоб він задавав розміри приєднання, яке оголошує Aggregate, або вкажіть однаковий Feature в обох документах.)

Як виправити: узгодьте дві декларації. Декларації того самого екземпляра функції на боці Aggregate і на боці Release поєднуються за стовпами — Aggregate додає values, Release додає infra. Якщо обидва боки задають те саме поле поза стовпами (як-от type:), значення мають збігатися; виправте один бік відповідно до іншого або вилучіть надлишкову декларацію.

Annotation binding does not resolve against its target Feature (Прив’язка анотації не розв’язується щодо цільової Feature)

Поле feature: прив’язки анотації в Manifest називає Feature, яку каталог не завантажує, або списки maps.infra / maps.values прив’язки оголошують шляхи з крапками, яких spec.schema названої Feature насправді не містить. Будь-яка з цих умов зупиняє завантаження робочого простору — прив’язка синтезувала б приєднання Feature, що маршрутизують значення в шляхи, яких середовище виконання не може розв’язати.

Одна умова охоплює три способи, у які маршрут прив’язки не розв’язується, і діагностика називає, який із них трапився:

  • Feature не знайдено. Значення feature: посилається на URI сутності Feature, якої немає в завантаженому каталозі.
  • Схема Feature не розв’язується. Названа Feature завантажується, але її spec.schema: не розв’язується до представлення JSON Schema 2020-12 — вміст хибно сформований або називає міждокументне посилання, за яким неможливо перейти. Цей варіант несе за собою власну діагностику збою розв’язання, тож причину, з якої схема не розв’язалася, видно з тієї самої зупинки.
  • Шляху прив’язки немає в цільовій схемі. Запис maps.infra або maps.values прив’язки називає шлях з крапками, якого не оголошує spec.schema.<pillar>.<path> сутності Feature.

Повідомлення, що виводиться (варіант «Feature не знайдено»):

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") (прив’язка анотації не розв’язується щодо цільової Feature (Manifest, у .spec.mappings.features.annotations.<key>, “<key>”, маршрутизує до Feature “<feature-uri>”, якої каталог цієї збірки не містить; виправте або опублікуйте Feature, названу під “feature”))

Повідомлення, що виводиться (варіант «схема не розв’язується»):

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>) (прив’язка анотації не розв’язується щодо цільової Feature (Manifest, прив’язка анотації маршрутизує до Feature “<feature-uri>”, оголошена схема якої не розв’язується: <resolution failure>))

Цей варіант називає Feature і збій розв’язання, але не містить ні ключа прив’язки, ні позиції в джерелі — помилка у власному spec.schema: сутності Feature, яку прив’язка лише називає. Знайдіть проблемну прив’язку, шукаючи в mappings.features.annotations URI сутності Feature, який цитує повідомлення.

Повідомлення, що виводиться (варіант «шлях не знайдено»):

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") (прив’язка анотації не розв’язується щодо цільової Feature (Manifest, у .spec.mappings.features.annotations.<key>, “<key>”, маршрутизує до Feature “<feature-uri>”, у стовпі “<pillar>” і шляху “<path>”, для якого ця Feature не оголошує властивості під “schema”))

Як виправити: переконайтеся, що URI feature: прив’язки існує в каталозі й збігається з чутливим до регістру URI, який реалізує Recipe через implements:. Якщо варіант «шлях не знайдено» спрацьовує на шляху, який схема Feature таки оголошує, перевірте написання шляху з крапками (з урахуванням регістру) і назву стовпа (infra чи values).

A bound annotation value does not conform to the target Feature’s schema (Прив’язане значення анотації не відповідає схемі цільової Feature)

Анотація, яку ви написали, спрямовує значення через прив’язку до шляху в цільовій Feature — і значення не задовольняє підсхему, яку Feature оголошує за цим шляхом, або Feature взагалі не оголошує там властивості. Умова перевіряється щодо значення, а не щодо прив’язки, тому вона відокремлена від зупинки щодо цілі прив’язки вище: та відхиляє те, що оголошує Manifest, а ця — те, що було записано через нього.

Повна валідація за знайденим шляхом; м’який пропуск лише тоді, коли шлях неможливо знайти. Щойно підсхему прив’язаного підключа знайдено, значення валідується за повним набором обмежень JSON Schema 2020-12 за цим шляхом (тип, enum, pattern, числовий діапазон, вкладена форма об’єкта/масиву) — кінцевий $ref / allOf / oneOf розв’язується за визначеннями схеми й валідується, а не пропускається. Дисципліна м’якого пропуску стосується лише навігації: коли обхід натрапляє на запасний вихід ($ref, patternProperties, oneOf/anyOf/allOf або additionalProperties з тілом-схемою) на проміжному сегменті — до досягнення прив’язаного листка, — шлях не можна розв’язати статично, тож валідатор продовжує роботу, не викликаючи помилки, щоб не ризикувати хибною зупинкою; поверхнею валідації для цієї прив’язки лишається середовище виконання.

Повідомлення, що виводиться (варіант невідповідності значення):

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> (підключ анотації не відповідає схемі цільової Feature у стовпі маршрутизації: значення <value> підключа анотації <subkey> не відповідає Feature <feature-uri> spec.schema.<pillar>.<subkey>: <constraint failure>)

Повідомлення, що виводиться (варіант неоголошеного підключа):

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> (підключ анотації не відповідає схемі цільової Feature у стовпі маршрутизації: підключ анотації <subkey> не оголошено у Feature <feature-uri> spec.schema.<pillar>.<subkey>)

Зупинка виникає для анотації в тому вигляді, як її написано, до її розгортання в підключення Feature, тож діагностика називає документ і область, у якій значення було написано, — межу та компонент для анотації з боку Release, шлях компонента для анотації з боку Aggregate, — і ключ анотації, з якого воно походить.

Анотація, яку впровадив плагін керування, оцінюється так само, і діагностика повідомляє, хто її написав. Плагін, підключений для впровадження анотацій, задає значення на компоненті Release, тож значення перевіряється точно так само, як записане там оператором, — але рядок Release, на який вказує діагностика, ніхто не писав. Тому діагностика додає, який плагін впровадив значення і до якої ролі керування його підключено, а виправлення слід вносити в рішення цього плагіна, а не в Release.

Як виправити: виправте прив’язане значення, щоб воно задовольняло оголошену підсхему, або розширте схему цієї властивості, якщо значення правомірне. Варіант неоголошеного підключа зазвичай випереджає зупинка щодо цілі прив’язки вище; якщо ви до нього дійшли, прив’язка оголошує шлях, а схема Feature його не містить, тож виправте те з двох, що хибне. Коли проміжний оператор композиції робить шлях нерозв’язним і середовище виконання згодом його відхиляє, звузьте схему, щоб властивість з’явилася безпосередньо за шляхом прив’язки.

An annotation subkey is not routed by its binding (Підключ анотації не спрямовується її прив’язкою)

Написана вами анотація містить підключі під ключем, який заявляє прив’язка анотацій Manifest, і один із цих підключів — ім’я, яке прив’язка не спрямовує: його не вказано ні в maps.infra, ні в maps.values. Кожен підключ спрямовується окремо — за шляхом Feature, який прив’язка для нього оголошує, тож підключу, якого прив’язка не називає, нікуди подітися. Розгортання анотації без нього мовчки виключило б написане вами значення зі збірки, а звичайна причина — помилка в написанні підключа, тому збірка натомість зупиняється, називаючи підключ, ключ анотації, під яким його записано, і кожен підключ, який прив’язка справді спрямовує.

Зупинка виникає для анотації в тому вигляді, як її написано, до її розгортання в підключення Feature, як і у двох сусідніх умов: «A bound annotation value does not conform to the target Feature’s schema (Значення прив’язаної анотації не відповідає схемі цільової Feature)» вище відхиляє підключ, який спрямовує прив’язка, коли Feature відхиляє його значення, а «An annotation routes through a pillar its authoring side may not use (Анотація спрямовується через стовп, який її бік авторства не може використовувати)» нижче відхиляє підключ, спрямований через неправильний стовп. Ключ, якого не заявляє жодна прив’язка, до цієї умови не належить: його ніщо не спрямовує, і збірка його пропускає.

Повідомлення, що виводиться, називає документ і місце, де написано анотацію, підключ, ключ анотації та підключі, які спрямовує прив’язка:

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>") (підключ анотації не спрямовується прив’язкою анотації (Release; підключ записано під цією анотацією, а її прив’язка спрямовує лише перелічені підключі))

Анотація, написана в Aggregate, називається так само — за місцем, де її там написано: (Aggregate <name>, at .spec.subsystems.<subsystem>.annotations, …) для анотації на підсистемі. Збірка повідомляє про анотацію з боку Release з тегом OPS_ERROR, а про анотацію з боку Aggregate — з тегом DEVELOPER_ERROR, відповідно до документа, який її написав.

Як виправити: порівняйте підключ із підключами, переліченими в повідомленні. Якщо це помилка в написанні, виправте його на підключ, який спрямовує прив’язка. Якщо значення має дійти до Feature, прив’язка мусить його спрямовувати: додайте шлях до maps.infra або maps.values прив’язки в Manifest — шлях, який оголошує схема Feature, — або видаліть підключ з анотації.

A bare annotation value does not route to exactly one path of its binding (Просте значення анотації не спрямовується рівно в один шлях її прив’язки)

Анотація, яку ви записали як просте значення — feature.aggrega.ai/monitoring: "30s", а не як мапу підключів, — не називає жодного підключа, тож ніщо в ній не вказує, який шлях Feature вона заповнює. Її розміщують в єдиному шляху, який оголошує прив’язка, рахуючи maps.infra і maps.values разом. Прив’язка, що оголошує більше одного шляху, залишає значенню кілька місць призначення й нічого, що дозволило б вибрати між ними, тож збірка зупиняється, а не вибирає одне з них. Підрахунок охоплює обидва списки, тож прив’язка, яка спрямовує один шлях через infra, а інший через values, відхиляє просте значення, в якому б документі його не було записано.

Зупинка виникає для анотації в тому вигляді, в якому її записано, до її розгортання в приєднання Feature, як і в сусідніх умовах, тож діагностика називає документ і місце, де записано значення. Перевірка виконується один раз для кожної записаної вами анотації: значення, записане на межі чи в підсистемі, відхиляється там, один раз, незалежно від того, чи бере його якийсь компонент усередині. Повідомляється про кожне таке значення у збірці, а не лише про перше. Збірка повідомляє про анотацію на боці Release з тегом OPS_ERROR, а про анотацію на боці Aggregate — з тегом DEVELOPER_ERROR, відповідно до документа, який її записав. Умова — a scalar annotation value does not route to exactly one path of its binding, і саме це aggrega explain виводить для її коду.

Повідомлення, яке видається, називаючи документ і місце, де записано анотацію, ключ анотації, значення та шляхи, якими спрямовує прив’язка:

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>") (скалярне значення анотації не спрямовується рівно в один шлях її прив’язки: ключ містить просте значення, а його прив’язка спрямовує в кілька шляхів)

Порожнє значення нічого не записує, тож його розміщують усюди, де один із двох списків містить єдиний шлях, і відхиляють лише там, де жоден його не містить. Прив’язка, яка взагалі не оголошує шляху, відхиляється під час завантаження Manifest, бо схема Manifest вимагає шлях, тож збірка не доходить до цієї умови таким чином.

Анотація, яку впровадив плагін керування, оцінюється так само, і її діагностика додає, який плагін упровадив значення та в якій ролі керування його приєднано, як і в сусідніх умовах.

Як виправити: запишіть анотацію як мапу, що називає підключ для кожного значення, — feature.aggrega.ai/monitoring: {interval: 30s}, — щоб кожне значення спрямовувалося за власним ім’ям; або дайте єдиному значенню власну прив’язку під іншим ключем анотації, яка оголошує лише шлях, що його воно заповнює.

An annotation routes through a pillar its authoring side may not use (Анотація спрямовується через стовп, який її бік авторства не може використовувати)

Анотації розділено за боком авторства, і цей поділ той самий, що керує кожним іншим авторським стовпом: анотація з боку Aggregate може спрямовуватися лише через шлях прив’язки, що цілить у values, а анотація з боку Release — лише через шлях, що цілить в infra. Будь-яке інше поєднання зупиняє збірку.

Саме поділ не дає скороченню через анотацію стати способом писати стовп іншого боку. Анотація розробника додає values; анотація оператора — розміри infra. Прив’язка, що оголошує шляхи в обох стовпах, сама по собі не є помилкою — кожен бік спрямовує дозволену йому підмножину, а шляхи іншого боку з нього просто недосяжні.

Прив’язка, що оголошує один шлях в обох списках стовпів, — випадок, який найчастіше доходить до цієї зупинки. Правило розв’язання нічиєї в маршрутизації спрямовує такий шлях через infra, що робить його недосяжним з боку Aggregate, і анотація з боку Aggregate, яка спрямовується до нього, зупиняється тут. Попередження, яке називає таку форму прив’язки ще до того, як збірка дійде до цієї зупинки, описано в warnings.md.

Повідомлення, що виводиться:

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> (анотація спрямовується через стовп, який її бік авторства не може використовувати: анотація <key> у <source> спрямовується через стовп <pillar> за шляхом <path>, але анотації з боку <side> можуть спрямовуватися лише через стовп <permitted-pillar>)

Анотація, яку впровадив плагін керування, розташована на компоненті Release, тож це анотація з боку Release, і до неї застосовується той самий поділ. Її діагностика додає, який плагін її впровадив і до якої ролі керування його підключено, бо ключ Release, на який вона вказує, ніхто не писав.

Як виправити: спрямуйте анотацію з того боку, у чий стовп цілить прив’язка, або додайте прив’язку — під власним ключем анотації, — шляхи якої цілять у стовп, дозволений боку авторства. Якщо одна прив’язка оголошує той самий шлях в обох списках стовпів, розділіть її на дві прив’язки, щоб кожен бік мав досяжний для себе шлях. Якщо діагностика називає плагін, що впровадив анотацію, анотація походить із рішення цього плагіна: виправте плагін або прив’язку, під якою він впроваджує.

Authored values or infra do not conform to the declared schema (Написані values або infra не відповідають оголошеній схемі)

Розв’язані values: або infra: екземпляра компонента — або приєднаної Feature — не відповідають оголошеній схемі каталогу. Збірка валідує кожен стовп за його оголошеною схемою перед рендерингом, тож ключ з одруківкою, значення неправильного типу, число поза діапазоном або відсутнє обов’язкове поле виявляються в їхньому джерелі, а не дають зламаний маніфест під час розгортання.

Перевірка охоплює стандартні обмеження схеми: значення неправильного типу (рядок там, де схема оголошує ціле число), значення поза оголошеним діапазоном або enum, значення, що не відповідає оголошеному pattern, рядок, що не є дійсним екземпляром оголошеного format — одного з іменованих форматів, — і обов’язкове поле, яке не надано. Помилка формату називає ключове слово й містить значення, формат і те, що з ним не так, — так, як aggrega pull і aggrega validate --release виводять її для поля uri зі значенням ::::: "format", "value \"::::\" is not a valid uri: a URI begins with a scheme followed by a colon, such as https:". Перевірка враховує значення за замовчуванням: поле, якому схема дає default:, вважається наданим навіть тоді, коли його пропущено, тож обов’язкове поле зі значенням за замовчуванням ніколи не спрацьовує на перевірці «відсутнє».

Стовп values — це авторська поверхня розробника. Він валідується як закритий — властивість, яку схема не оголошує, відхиляється як імовірна одруківка. Схема values, що компонується в межах власного документа (локальний #/$defs $ref або allOf), розв’язується й валідується в цьому контексті визначень.

Стовп infra — це поверхня розмірів оператора, і він перевіряється лише тоді, коли Component оголошує стовп schema.infra — це оголошення є контрактом, до якого компонент долучається. Він валідується як закритий за цим оголошенням і ні за чим іншим, так само як стовп values валідується за schema.values: ключ, який Component не оголошує, відхиляється як одруківка, а для ключа, який він оголошує, примусово перевіряються тип і діапазон. Компонент, який хоче валідувати ключ, що нашаровує провайдер, як-от replicas, оголошує цей ключ у власній schema.infra; прийнятий словник провайдера досягається через valuesMapping його Recipe, а не нашаровується на авторську поверхню infra.

Перевірка вимірює розміри кожного компонента, який Release розмістив, і запис, що взагалі не містить блоку infra:, теж вимірюється: відсутній блок — це порожній блок, тож ключ required: без default: повідомляється як відсутній — а саме для цього випадку такий ключ і існує. Зараховуються обидва способи розміщення компонента. Його розміщує зазначення під components межі, а також маршрутизація під aggregates підмодуля, що його додає; запис маршрутизації розміщує компоненти, нічого не кажучи про жоден із них, тож компонент, розміщений так, починає з порожнього блоку розмірів, і ключ required: без значення за замовчуванням у його типі повідомляється як відсутній. Компонент, який Release не розміщує жодним із цих способів, за цим контрактом не вимірюється взагалі. У нього інша вада, і збірка повідомляє саме про неї: компонент не розміщено в жодній межі, із зазначенням двох способів його розмістити.

Контракт зобов’язує компонент, де б його не було написано: компонент, який додає підмодуль, вимірюється так само, як і той, що його оголошує власний Aggregate сутності Release. Глибина вкладеності компонента не змінює того, які обмеження його типу застосовуються.

Приєднання Feature валідуються так само — за оголошеними в приєднаній Feature schema.values / schema.infra. Приєднання мають одну спільну поверхню, тож Feature облікових даних — позначена feature.aggrega.ai/kind: secret — перевіряється за власною оголошеною схемою точно так, як і будь-яке інше приєднання. Перевіряється ефективний об’єднаний результат після каскадування значень приєднання між областями (компонент, підсистема, межа та специфічна для компонента) — тож значення, законно введене в одній області, але перевизначене на неприпустиме в конкретнішій області, виявляється в об’єднаному результаті, а не у фрагменті. Приєднання, тип якого не оголошує схеми, не валідується; infra приєднання валідується за власною schema.infra приєднання (приєднання є накладкою і не несе об’єднання постачальника).

Знахідка щодо вкладення повідомляється в документі, який написав хибний стовп, під назвою цього документа, і зараховується його авторові. Його values повідомляються в блоці Aggregate, який їх написав, — у власному записі features: компонента, .spec.components.<component>.features.<attachment>.values.<field>, перед блоком підсистеми, що досягає компонента, — як помилка розробника. Його infra повідомляється в блоці Release, який його написав, — у записі Release для компонента, під межею, що його називає, перед власним блоком features: межі, — як помилка оператора. Стовп, який не написав документ, що ним володіє, повідомляється там, де написано саме вкладення, тобто там, де названо його type. Тож вкладення, яке створює лише Release і яке не несе values, повідомляє про поле, якого вимагають values його сутності Feature, у записі Release і як помилку оператора, за шляхом, який містить Release, — у записі компонента або в блоці features: межі для вкладення, яке межа створює для кожного компонента в ній:

[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))

Те саме приєднання, записане на компоненті в Aggregate, повідомляє [DEVELOPER_ERROR E0168] за шляхом .spec.components.app.features.check.values.schema, під назвою Aggregate. Редактор показує кожне з них на документі, що його записав, на найглибшому ключі цього шляху, який містить документ.

Вкладення, яке несе з’єднання, вимірюється так само і повідомляється в записі з’єднання документа, який написав хибний стовп, а не у власному блоці features: компонента, який його не містить. Його values повідомляються в записі з’єднання Aggregate, .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field> — у власному документі підмодуля, для компонента, який додає підмодуль, — а його infra — у записі Release для цього з’єднання, під межею, що називає компонент, якщо Release називає межі. Вкладення, яке створює лише Release, повідомляється в записі Release для обох стовпів: таке вкладення не несе values, тож сутність Feature, чиї values вимагають поля, повідомляє про його відсутність саме там, у записі, який написав оператор.

Конфігурація з’єднання для кожного ребра перевіряється так само щодо контракту сокета для ребра: написані розробником values ребра — щодо valueSchema сокета, а написаний оператором infra ребра (з Release) — щодо infraSchema сокета. Сокет, який не оголошує схеми для ребра для певного стовпа, не приймає для нього перевіреної конфігурації (пропуск = немає контракту, нічого перевіряти). Діагностика називає ребро за споживачем, сокетом і псевдонімом. Для компонента, який оголошує власний Aggregate сутності Release, infra оператора вимірюється для кожного запису, який Release пише для одного з його з’єднань, — включно із записом без infra, саме так про відсутній ключ required: без значення за замовчуванням повідомляється, — і повідомляється в цьому записі в Release, під межею, що називає компонент, якщо Release називає межі, тобто там, де оператор його редагує; values розробника повідомляються в записі з’єднання в Aggregate.

Для листка, оголошеного sensitive: true, порушення обмеження приховується. Текст порушення цитує хибне значення, а діагностику збірки читає кожен, хто стежить за збіркою, тож для листка, оголошеного чутливим, — або будь-де всередині об’єкта, оголошеного чутливим, — <constraint failure> нижче замінюється на <redacted>. Те саме діє для позиції, під якою міститься листок, оголошений чутливим, включно із самим стовпом: $ref, записаний поруч з іншими ключовими словами, перевіряється цілком там, де його записано, тож порушення всередині визначення, яке він називає, повідомляється в цій позиції й інакше цитувало б значення листка. Сутність, шлях поля, стовп і назва контракту, як і раніше, називаються, тож діагностика все одно повідомляє, де сталося порушення; відкидається лише текст, що відтворив би значення. Чутливість визначається для кожного стовпа окремо, тож листок з однаковою назвою у values та infra приховується лише в тому стовпі, який його оголошує.

Повідомлення, що виводиться:

authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.values.<field>, “values.<field>”, “<keyword>”, “<constraint failure>”) (написаний стовп не відповідає своїй оголошеній схемі) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.components.<component>.infra.<field>, “infra.<field>”, “<keyword>”, “<constraint failure>”) (написаний стовп не відповідає своїй оголошеній схемі) 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>) (написаний стовп не відповідає своїй оголошеній схемі: стовп values не відповідає схемі 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>) (написаний стовп не відповідає своїй оголошеній схемі: стовп infra не відповідає схемі 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>) (написаний стовп не відповідає своїй оголошеній схемі: стовп values не відповідає схемі 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>”) (написаний стовп не відповідає своїй оголошеній схемі) 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>) (написаний стовп не відповідає своїй оголошеній схемі: стовп values не відповідає схемі 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>) (написаний стовп не відповідає своїй оголошеній схемі: стовп values не відповідає схемі 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>”) (написаний стовп не відповідає своїй оголошеній схемі)

Як виправити: виправте хибне значення, щоб воно відповідало оголошеній схемі, або — якщо значення законне — розширте оголошувальну схему (schema.values/schema.infra сутності Component або схему приєднаної Feature), щоб оголосити його. Перегляньте оголошену схему сутності Component за допомогою aggrega inspect <component-type>, щоб побачити точні типи, діапазони, значення за замовчуванням і обов’язкові поля, яких очікує кожен стовп.

A declared schema contract cannot be read as a schema (Оголошений контракт схеми неможливо прочитати як схему)

Сутність Component або Feature оголошує контракт схеми, який не дає нічого, з чим можна було б звіряти, тож конфігурація, яку він охоплює, ні з чим не звіряється. Помилку можуть містити три контракти, кожен з яких записується у власному полі: власний spec.schema сутності та два контракти для окремих ребер, які оголошує сокет залежності, — valueSchema для боку розробника у з’єднанні та infraSchema для боку оператора. Запис SchemaLibrary, на який можуть посилатися ці контракти, теж може містити третю з наведених нижче помилок; як повідомляється про такий випадок, описано далі.

До цієї зупинки призводять три помилки, і дві з них легко пропустити, бо контракт виглядає правильним. Контракт сокета може взагалі не скомпілюватися в JSON Schema 2020-12 — найчастіша причина полягає в помилці в ключовому слові; власна spec.schema сутності, яка не компілюється, натомість повідомляється за тією умовою компактної форми, на яку натрапила її компіляція (E0120 для невідомого ключового слова, E0116 для обмеження, якого не приймає її тип). Або він може скомпілюватися без помилок і все одно не створити валідатора: тіло читається як компактна форма, але не є схемою, з якою можна щось звіряти, наприклад голий скаляр там, де має бути схема властивості (items: nonsense). Або він може бути правильно сформованим в усьому іншому, але називати формат поза підтримуваним набором — format: password чи помилкове написання на кшталт format: emial, — і такий контракт відхиляється, а не читається як обмеження, що нічого не перевіряє, незалежно від того, чи потрапляє в поле якесь значення; назви, які може мати format, перелічено в розділі Іменовані формати. Усі три є однією умовою, бо спосіб виправлення однаковий, а пропуск будь-якої з них має однакові наслідки.

Відсутність оголошеного контракту та оголошення контракту, який неможливо прочитати, — різні ситуації, і збірка обробляє їх по-різному. Поле, яке нічого не оголошує, пропускається: перевірка відповідності для окремих стовпів і окремих ребер вмикається за бажанням, тож сокет, що не обмежує жодного стовпа, є звичайним авторським рішенням і не спричиняє діагностики. Поле, яке оголошує щось непрочитне, відхиляється. Пропуск такого поля залишив би неперевіреним кожне корисне навантаження, яке воно охоплює, тоді як збірка повідомила б про успіх, — перевірка, яка перестала виконуватися, і ніщо не повідомляє, що вона зупинилася. Тож саме відхилення розрізняє ці випадки: тиша означає, що перевіряти не було чого, а зупинка означає, що щось було, але його неможливо прочитати.

Відхилення називає сутність, яка оголосила контракт, а не документ, у якому записано конфігурацію, бо саме там потрібне виправлення. Авторові Aggregate, який отримав тип компонента з непрочитним контрактом, нічого змінювати у власному файлі. Відхилення виникає під час читання каталогу, коли відомі сутність, що оголошує контракт, стовп, записане поле та рядок вихідного коду, — тож та сама помилка повідомляється однаково, незалежно від того, чи ви натрапили на неї під час збірки, через aggrega validate чи через інструмент збірки, який надає aggrega mcp. Контракт, який сутність читає через $import: — увесь її spec.schema, один його стовп або контракт сокета, — повідомляється в імпортованому файлі: розташування називає цей файл і рядок у ньому, де записано фрагмент, а повідомлення, як і раніше, називає сутність і поле, що оголосили контракт. Зупинки компактної форми, на які натрапляє власний spec.schema сутності, локалізуються так само.

Запис SchemaLibrary, що називає формат поза підтримуваним набором, призводить до цієї зупинки під час читання його бібліотеки, і відхилення називає бібліотеку та запис і вказує на запис у файлі бібліотеки. aggrega validate для всього каталогу читає кожну бібліотеку, тож повідомляє про запис незалежно від того, чи посилається на нього якась схема, тоді як сутність Release, розв’язання залежностей якої ніколи не доходить до бібліотеки, її не читає. Сутність Release, схеми якої таки доходять до запису через $ref:, теж відхиляється, але відхилення не називає формат: aggrega pull повідомляє, що бібліотеку не знайдено в каталозі (E0114), а aggrega validate --release повідомляє, що не знайдено ціль посилання (E0121). Запустіть aggrega validate для каталогу, щоб побачити запис і назву, у якій помилка.

Повідомлення передає помилку так, як про неї повідомив інструмент, що на неї натрапив: для помилки компіляції — ключ усередині контракту, рядок вихідного коду та помилкове ключове слово; для тіла, яке не створює валідатора, — позицію, яку відхилив валідатор; для назви формату поза підтримуваним набором — поле, ключове слово format, назву в тому вигляді, як її записано, і кожну підтримувану назву. Міждокументне $ref: у контракті сокета, запис SchemaLibrary якого відсутній у завантаженому замиканні, призводить до тієї самої зупинки, коли aggrega validate перевіряє сутність або сутність Release; у власній spec.schema сутності про нього повідомляється так, як описано вище в розділі «A $ref: is not written in a form the compiler can resolve (Посилання записано не у формі, яку компілятор може розв’язати)». aggrega pull читає обидва місця в пошуках бібліотек, потрібних сутності Release, тож бібліотека, якої немає в каталозі, зупиняє pull раніше, як описано в розділі «A reference names no entity the catalog holds (Посилання називає сутність, якої немає в каталозі)» (E0114), хоч би з якого з двох місць на неї посилалися, — а бібліотека, яка є в каталозі, закріплюється в lock-файлі для будь-якого з них.

Правильно сформоване обмеження поруч із непрочитним не застосовується. Контракт читається як один документ, тож один непрочитний фрагмент вимикає кожне обмеження, оголошене поруч із ним. Саме тому зупинка варта більше, ніж обмеження, яких вона коштує: альтернатива — контракт, який виглядає застосованим, читається як застосований і нічого не застосовує.

Повідомлення, яке видається, називає сутність із її версією та поле, що оголошує контракт, потім стовп, який обмежує цей контракт, потім помилку — тут контракт сокета з помилкою в ключовому слові:

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 (оголошений контракт схеми не вдалося скомпілювати в придатну схему, тож за ним нічого не перевірялося: виправте контракт там, де його оголошено, або вилучіть його, якщо конфігурація, яку він охоплює, не потребує перевірки. Component: valueSchema сокета в spec.usesSchema оголошує схему, з якої неможливо побудувати валідатор, тож значення, які вона обмежує, залишилися б неперевіреними: compactform у вказаних ключі й рядку (вказане ключове слово): невідоме ключове слово)

і назву формату поза підтримуваним набором у стовпі values сутності 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)

Сутність Feature називається Feature "<name>:<version>", контракт сокета — його власним полем, наприклад spec.usesSchema.<socket>.infraSchema, а стовп — тим, який обмежує контракт: values, infra або provides. aggrega validate, отримавши власний файл сутності, називає сутність без версії. Запис SchemaLibrary називається своєю бібліотекою та своїм записом:

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)

Як виправити: відкрийте поле, яке називає діагностика, і виправте фрагмент у вказаному ключі та рядку — найчастіше це помилка в ключовому слові, яку слід звірити зі словником ключових слів у vocabulary/compact-form-authoring.md, або значення, записане там, де має бути вкладена схема. Якщо помилка називає непідтримуваний формат, запишіть один з іменованих форматів або видаліть format:; поле із секретними даними натомість оголошує sensitive: true, бо password не є форматом. Для запису SchemaLibrary виправлення вноситься у файл бібліотеки, який називає діагностика. Якщо помилка називає міждокументне посилання, переконайтеся, що запис SchemaLibrary існує і що бібліотека досяжна із замикання залежностей сутності Release. Якщо конфігурація, яку охоплює це поле, справді не потребує перевірки, видаліть поле, а не залишайте контракт, який ніщо не може прочитати.

source: у Recipe — порожній рядок

Recipe оголошує source: "" — порожній рядок. Поле source: у сутності Recipe обирає між двома режимами авторингу: режимом sourceless, де зовнішнього артефакту немає і вихідні дані повністю створюються з інших видів вхідних даних Recipe, і режимом sourced, де source: називає зовнішній chart, модуль або файл, з якого виконується рендеринг. Пропуск поля обирає перший режим, непорожнє значення — другий, а порожній рядок не обирає жодного, тож це неоднозначність, а не значення з певним змістом. Поле source:, записане як null, рівнозначне його пропуску.

Сутність Recipe відхиляється замість того, щоб компілятор обирав за вас одне з двох тлумачень. Найчастіше порожнє source: виникає, коли URI видаляють, а ключ залишають: передбачався режим із джерелом, і прийняття порожнього рядка як режиму без джерела випустило б компонент без артефакту, ніколи не сказавши, яке з двох тлумачень було обрано.

Це правило перевіряється під час завантаження сутності Recipe, і значення читається точно так, як ви його написали, тож кожна команда, що завантажує сутність Recipe, називає цю умову раніше, ніж щось спробує використати порожнє значення. aggrega validate над файлом Recipe відхиляє його; aggrega pull, збірка, aggrega validate --release та інструмент збірки, який надає aggrega mcp, повідомляють про нього для сутності Release, що досягає цієї сутності Recipe, раніше за посилання на Recipe, яке через це вже не вдалося розв’язати. Тому pull називає цю умову, а не повідомляє про порожнє посилання як про таке, вид джерела якого він не може визначити. Перевірка відбувається раніше за правила, що читають, чи оголошено джерело, тож сутності Recipe з порожнім source: повідомляють саме про source:, а не про valuesMapping, якому нема чого накладати, чи про відсутній вид вхідних даних.

Повідомлення, що виводиться, розташоване на файлі Recipe, у якому записано порожнє source:, і на ключі всередині нього — .spec.source, — а не на компоненті, що прив’язує цей Recipe, бо цей запис спільний для всіх компонентів, які це роблять:

recipe source is an empty string, which names neither sourceless mode nor sourced mode (Recipe <name>:<version>, at .spec.source). omit the source field for sourceless mode, or name a non-empty path or URI for sourced mode (джерело recipe — порожній рядок, який не називає ні режиму без джерела, ні режиму із джерелом. Пропустіть поле source для режиму без джерела або вкажіть непорожній шлях чи URI для режиму із джерелом)

Збірка виводить цей рядок під тегом CATALOG_ERROR з коротким кодом цієї умови, E0251, і файлом Recipe поруч.

Як виправити: повністю пропустіть поле source: (або встановіть його в null), якщо Recipe без джерела, або вкажіть непорожній шлях / URI / структурований об’єкт джерела, якщо Recipe із джерелом.

No Recipe is mapped for a component or feature instance (Для екземпляра компонента чи функції не зіставлено жодного Recipe)

Тип екземпляра не має зіставлення в Manifest, яке вказує на Recipe, наявний у каталозі. Вибір Recipe відбувається лише через зіставлення: компілятор ніколи не обирає Recipe, читаючи spec.implements: і вибираючи серед кандидатів, тож незіставлений тип зупиняє збірку незалежно від того, скільки Recipes його реалізують. implements інформує вибір; автор його робить; Manifest його фіксує.

Та сама умова охоплює зіставлення, яке існує, але нікуди не веде: значення допустимої форми посилання, що називає Recipe, якого немає в каталозі, зокрема такий, що присутній з іншою версією, ніж закріплює значення, і такий, чию просту назву пропонують дві можливості одночасно. Жодне з них не вказує на Recipe, про який можна сказати, що його обрав автор. Про значення зіставлення, чию форму не може виразити жодне посилання, повідомляється окремо, у розділі «Manifest mapping value is not a shape a recipe reference accepts (Значення зіставлення в Manifest має форму, якої не приймає посилання на recipe)» вище, тож твердження про відсутність сутності робиться лише щодо посилання, яке могло б бути розв’язане.

Повідомлення, що виводяться, для екземпляра компонента. Коли зіставлення існує й називає щось відсутнє:

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 (для екземпляра компонента/функції не розв’язано жодного recipe: додайте явне зіставлення Manifest для його типу. Виправте значення зіставлення в Manifest або опублікуйте recipe, який воно називає)

Коли зіставлення немає, а Recipes, що реалізують тип, присутні, їх перелічено як кандидатів для закріплення:

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 (для екземпляра компонента/функції не розв’язано жодного recipe: додайте явне зіставлення Manifest для його типу. Закріпіть один із них у Manifest)

А коли тип не реалізує взагалі ніщо, перелічувати нічого:

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 (для екземпляра компонента/функції не розв’язано жодного recipe: додайте явне зіставлення Manifest для його типу. Жоден recipe у каталозі не реалізує цей тип; напишіть його, а потім зіставте з ним тип)

У робочому просторі, який не називає жодної теки каталогу, шукаються лише сутності Recipes, закріплені в lock-файлі: сутності з реєстру не перелічуються, а сутність Manifest, яка не зіставляє для типу жодної, жодної й не закріплює. Там, коли жодна закріплена сутність Recipe не реалізує тип, твердження про відсутність стосується закріплених записів, а не каталогу, і повідомлення про це каже:

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 (для екземпляра компонента/функції не розв’язано жодного рецепта: додайте в Manifest явне зіставлення для його типу (Manifest, у вказаному місці, для вказаних екземпляра й типу). жоден рецепт, закріплений у lock-файлі, не реалізує цей тип; без теки каталогу шукаються лише рецепти, закріплені в lock-файлі, а не рецепти реєстру; закріпіть у Manifest рецепт, опублікований реєстром, або напишіть власний, а потім зіставте тип із ним)

Для типу, який сутність Aggregate записує без версії, пропонуються Recipes, що реалізують версію, за якою збірка його компілює, — найвищу версію цієї сутності Component, яку містить каталог. Для екземпляра core/datastore/postgres, коли каталог містить цю сутність Component у версії 1.0.0, пропонується кожен Recipe, що оголошує spec.implements: core/datastore/postgres:1.0.0, а також кожен, що оголошує тип без версії або діапазон із кареткою, який допускає 1.0.0. Для типу, сутності Component якого каталог не містить, пропонуються лише Recipes, що оголошують саме цей тип без версії.

Екземпляр функціональності повідомляє про ці випадки у власній формі, кожен після речення умови. Тип функціональності, який сутність Aggregate записує без версії, зіставляється так само, як тип компонента, — у версії, у якій збірка його компілює, тобто в найвищій версії цієї сутності Feature, яку містить каталог, — а повідомлення, що називає <type>:<version>, називає тип у цій версії, тобто те, що шукали в каталозі. Коли відома сутність Recipe, на яку зіставлено компонент прив’язки, сутності FeatureRecipes розрізняються за можливістю, до якої прив’язується ця сутність Recipe: ті, що прив’язуються до можливості компонента, пропонуються першими, а сутність FeatureRecipe, що прив’язується до іншої можливості, однаково рендериться — як власний вивід поруч із виводом компонента, а не всередині нього, — тож коли жодна не прив’язується до можливості компонента, натомість пропонуються ті. Зіставлення, яке нікуди не веде, має вигляд feature "<instance>" (type "<type>"): the Manifest maps it to feature recipe "<uri>", which is not in the catalog. Коли сутності FeatureRecipes реалізують тип для можливості компонента, перелічуються лише вони: 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. Коли вони реалізують його лише для інших можливостей: 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. Коли жодна взагалі не реалізує тип: feature "<instance>" (type "<type>"); no feature recipe in the catalog implements <type>:<version>; write one, then map the type to it. А коли можливість невідома — власне зіставлення компонента не розв’язується в жодну сутність Recipe, про що повідомляється окремо, або прив’язку записано на межі, компоненти якої можуть рендеритися через кілька можливостей, — перелічується кожна реалізація: feature "<instance>" (type "<type>"); feature recipes implementing it: [<recipe-uris>]; pin one in the Manifest. У робочому просторі, який не називає жодної теки каталогу, шукаються лише сутності FeatureRecipes, закріплені в lock-файлі: сутності з реєстру не перелічуються, а сутність Manifest, яка не зіставляє для типу жодної, жодної й не закріплює. Там твердження про відсутність стосуються закріплених записів, а не каталогу, і повідомлення про це кажуть. Коли жодна не реалізує тип: 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 — а коли можливість невідома, повідомлення не називає жодної й закінчується на pin one a registry publishes in the Manifest, or write one, then map the type to it. Коли закріплені сутності FeatureRecipes реалізують його лише для інших можливостей, повідомлення для цього випадку містить no feature recipe the lockfile pins implements замість no feature recipe in the catalog implements, з тим самим підрядним реченням після можливості.

Як виправити: додайте зіставлення, якого вимагає повідомлення, у spec.mappings.components.type в Manifest, із ключем — типом компонента і значенням — Recipe. Коли повідомлення перелічує кандидатів, оберіть одного з них: цей список — саме ті Recipes, які оголошують, що реалізують тип у версії, до якої його розв’язує збірка. Коли воно називає Recipe, якого немає в каталозі, виправте значення або додайте Recipe до каталогу, який читає збірка; версія у значенні має збігатися з версією, наявною в каталозі. Коли тип не реалізує ніщо, бракує самого Recipe. Коли повідомлення каже, що шукаються лише рецепти або рецепти функцій, закріплені в lock-файлі, робочий простір не читає жодної теки каталогу, тож реєстр однаково може публікувати Recipe або FeatureRecipe, що реалізує тип: саме зіставлення типу з ним у Manifest змушує pull отримати й закріпити його.

A Manifest name mapping names nothing in the build (Зіставлення name у сутності Manifest не називає нічого у збиранні)

Ключ у spec.mappings.components.name або spec.mappings.features.name не називає жодного екземпляра компонента чи приєднання, що є у збиранні. Рівень name зіставляється за точною назвою того, що реалізується: ключ components.name — з назвою екземпляра компонента так, як її пише Aggregate, а ключ features.name — з власною назвою приєднання, тобто ключем, під яким його записано у features: компонента, або <alias>.<slot> для приєднання, записаного на з’єднанні, — і ніколи з назвою компонента, до якого приєднання прикріплено. До ключа, який нічого не називає, ніколи б не зверталися: кожен екземпляр, для якого він призначався, розв’язувався б через рівень type, і збирання завершилося б, ані словом не згадавши проігнорований запис. Тому збирання зупиняється, перш ніж щось відрендерити.

Повідомлення називає сутність Manifest, ключ і розділ, у якому його записано, назви цього виду, які у збиранні є, — звужуючи їх до типу, який реалізує Recipe або FeatureRecipe запису, якщо цей тип відомий і у збиранні є його екземпляр, — і, де це можна визначити, назву, яку ви, імовірно, мали на увазі: для ключа features.name, що є назвою компонента, — приєднання цього типу, які несе компонент; для ключа components.name, що є назвою приєднання, — компонент, який його несе; в інших випадках — назву на відстані одного редагування.

Повідомлення, яке видається для ключа features.name, записаного як назва компонента, до якого прикріплено приєднання:

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>"? (ключ зіставлення name у Manifest не називає жодного екземпляра компонента чи приєднання в цьому збиранні, тож запис нічого не зв’язує: ключ у mappings.features.name сутності Manifest: жодне приєднання в цьому збиранні так не називається; ключ features.name називає приєднання його власною назвою — ключем, під яким його записано у features компонента, або псевдонімом зі слотом для приєднання на з’єднанні, — і ніколи не називає компонент, до якого його прикріплено; приєднання вказаного типу в цьому збиранні перелічено; вказана назва — це компонент, а ключ features.name називає приєднання, а не компонент, до якого його прикріплено, — можливо, ви мали на увазі вказане приєднання?)

І для ключа components.name, що відрізняється на одне редагування від назви екземпляра:

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>"? (ключ зіставлення name у Manifest не називає жодного екземпляра компонента чи приєднання в цьому збиранні, тож запис нічого не зв’язує: ключ у mappings.components.name сутності Manifest: жоден екземпляр компонента в цьому збиранні так не називається; ключ components.name називає екземпляр компонента точно так, як його пише Aggregate; екземпляри компонентів вказаного типу в цьому збиранні перелічено; можливо, ви мали на увазі вказаний екземпляр?)

Про кожен ключ, який нічого не називає, повідомляється в одному збиранні в тому порядку, у якому їх записано в Manifest.

Як виправити: перейменуйте ключ на назву, яку пропонує повідомлення, або на одну з перелічених у ньому назв — для приєднання це назва, під якою його записано, а не назва його компонента. Якщо запис більше не потрібен, вилучіть його; екземпляри цього типу тоді розв’язуватимуться через рівень type.

A Manifest maps two version-distinct keys onto one type (Manifest зіставляє з одним типом два ключі, що відрізняються версією)

Пошук типу збігся з кількома ключами зіставлення в Manifest. Ключі типів зіставляються без урахування версії, тож core/api-server, core/api-server:1.0.0 і core/api-server:2.0.0, записані як окремі ключі зіставлення, усі відповідають тому самому базовому типу, і пошук, що досягає двох із них, має два Recipes на вибір і жодного правила, щоб віддати перевагу одному.

Збірка зупиняється, а не розв’язує той ключ, який випадково прочитала першим. Вибір одного з них зробив би вивід рендерингу залежним від порядку обходу зіставлення, а саме це виключає побайтово ідентичний вивід.

Повідомлення, що виводиться:

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 зіставляє з одним базовим типом кілька ключів, що відрізняються версією; пошук recipe за типом неоднозначний — закріпіть версію написаного типу або видаліть дублікати ключів зіставлення)

Як виправити: є два шляхи, і повідомлення називає обидва. Видаліть дублікати ключів зіставлення, залишивши той, що має відповідати типу, — це правильно, коли зайві ключі залишилися після підвищення версії. Або закріпіть версію на боці авторингу, щоб тип, оголошений компонентом, називав саме той ключ, який ви мали на увазі, — це правильно, коли кілька ключів навмисні й різним компонентам справді потрібні різні Recipes.

Дві сутності каталогу в одному каталозі мають однакову ідентичність

Дві сутності одного виду, завантажені з одного каталогу, мають однакову ідентичність. Ідентичність — це те, що називає посилання, тож два файли, які претендують на одну ідентичність, дають кожному посиланню на неї дві відповіді.

У межах одного каталогу це зупиняє збірку; між різними каталогами — ні. Та сама ідентичність у двох різних каталогах розв’язується як затінення за першим збігом — перемагає каталог, указаний раніше, — і саме це дає змогу локальному каталогу навмисно перевизначити опубліковану сутність. Лише колізія всередині одного каталогу є помилкою автора, яку жодне прочитання не робить навмисною.

Це правило однакове для кожного індексованого виду: Component, Feature, Recipe, FeatureRecipe, Plugin, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary і Aggregate. Зупинка прив’язана до другого файлу й називає вид та ідентичність, що зіткнулися.

Повідомлення, що виводиться:

duplicate entity identity within a single catalog directory (Component identity "<identity>") (дубльована ідентичність сутності в межах одного каталогу: ідентичність сутності Component)

де замість Component стоїть слово відповідного виду — recipe identity, feature recipe identity, Plugin identity, SchemaLibrary identity тощо.

Як виправити: перейменуйте одну з двох сутностей або перемістіть її в окремий каталог. Для сутності Recipe чи FeatureRecipe ідентичність містить область провайдера та версію, тож два файли, що відрізняються лише версією, не конфліктують — справжня колізія там означає, що ту саму версію опубліковано двічі. Зазвичай причина в тому, що файл сутності скопіювали як основу для нової й забули змінити metadata.name.

Два місця читаються цілком, а не по одному файлу: каталог сутностей, з будь-якого документа в якому може відповісти пошук за назвою, і каталог, що містить сутність Release, щодо якого розв’язуються його Aggregates і Manifests, коли Release називає їх за ідентичністю. Символьне посилання серед цих файлів може вести будь-куди на машині, тож для кожного такого каталогу є каталог, у межах якого мають залишатися його читання, а посилання, що веде за його межі, не читається. Межа робочого простору описує правило, яке тут застосовується, та інші шляхи, на які воно поширюється.

Який це каталог, залежить від того, де розташований каталог, що читається:

  • Робочий простір — для каталогу або каталогу сутності Release усередині нього. Це стосується й каталогу catalog, який робочий простір має за домовленістю, коли його ніхто не назвав, тобто коли його читають лише тому, що він існує: тоді він належить самому робочому простору, тож catalog, який сам є посиланням, що веде за межі робочого простору, не читається.
  • Названий вами каталог, що лежить поза робочим простором, для того, що лежить у ньому: каталог каталогу сутностей, який ви передаєте через --catalog або який конфігурація робочого простору перелічує в catalog_dirs — для робочого простору чи для однієї сутності Release, — а також каталог названої вами сутності Release або тієї, яку називає конфігурація, що лежить поза робочим простором. Сам каталог використовується так, як ви його назвали — каталог, що є посиланням, читається там, куди воно вказує, — а те, що читається в ньому, лишається всередині нього. Це стосується й домовленого каталогу catalog, щойно ви його назвете: якщо його перелічено в catalog_dirs або передано через --catalog, catalog, що є посиланням за межі робочого простору, читається там, куди воно вказує, як і будь-який інший названий вами каталог. Якщо натомість назвати місце, на яке воно вказує, у будь-якому написанні, або каталог вище за це місце, це місце теж вважається названим: названий вами каталог уже читає те, що там лежить, тож воно читається один раз, через цей каталог. Назвати каталог у конфігурації — це спосіб, у який робочий простір читає сутності, що зберігаються поза ним.

Оцінюється кожен запис, з якого читання щось узяло б: посилання на файл, названий як документ YAML, і посилання на каталог, який може містити власні документи. Посилання, що веде кудись усередину каталогу, у межах якого має залишатися читання, читається там, де обхід його зустрічає. Посилання на файл, з якого жодне читання каталогу нічого не бере, — файл нотаток, архів чарта — тут не оцінюється, а за посиланням, що нікуди не веде, немає чого читати.

Пошук, від якого залежить компіляція, зупиняється на такому посиланні, а не пропускає його. Сутність за посиланням може бути саме тією, яку називає посилання, і мовчазний пропуск дав би змогу іншій сутності з тією самою назвою з пізнішого каталогу розв’язатися замість неї. Тому aggrega build, aggrega pull, aggrega validate, aggrega inspect там, де він читає каталог, лінтинг одного Release, а також запити редактора й асистента, які збирають, переглядають, будують граф, перевіряють або описують Release, зупиняються ще до будь-якого розв’язання, називаючи посилання. Лінтинг усього каталогу зупиняється так само: його вердикт стосується кожного документа в каталогах, тож він не повідомляє про чистий каталог, поки один із документів не вдалося прочитати. Каталог сутності Release підпорядковується тому самому правилу, коли Release називає свою сутність Aggregate чи Manifest за ідентичністю або коли Manifest так само називає Manifest, який він розширює, і сканування зупиняється на посиланні серед документів поруч із Release навіть тоді, коли це посилання не те, яке називає посилання на сутність, з тієї ж причини, з якої там його зупиняє дублікат: каталог не може відповідати за назву, поки один із його документів не можна прочитати. Сама сутність Release, яку назвали операції, — або Manifest, який ви переглядаєте окремо, — не належить до цих документів: її прочитано там, де її названо, тож Release, що сам є посиланням за межі, читається там, куди вказує, а те, що вона називає, шукається поруч із посиланням, у каталозі, де ви її назвали (A Release or a Manifest named through a link).

Перелік натомість пропускає таке посилання й нічого за ним не показує. Індекс сутностей редактора, його автодоповнення та запропоновані кандидати не містять сутності, яку представляє посилання за межі, а індекс сутностей називає таке посилання всередині робочого простору серед посилань, які він не прочитав.

Файли конфігурації робочого простору так само прив’язані до робочого простору. Кожен .aggrega-config.yaml від кореня робочого простору до каталогу, у якому виконується команда, і .aggrega-config-append-ci.yaml, який конвеєр тримає поруч із будь-яким із них, є власним вмістом робочого простору. Файл, що є посиланням за межі робочого простору — або до якого дісталися через посилання на каталог, що веде за межі, — не читається, і оскільки кожна команда, мовний сервер редактора та інструменти асистента читають конфігурацію насамперед, кожен із них зупиняється на цьому, називаючи посилання, а не працює з конфігурацією, складеною з того, що залишилося. Мовний сервер і сервер асистента, що працює через власні потоки, усе ж запускаються для такого робочого простору: переліки його сутностей Release та інших сутностей відповідають, прочитані без жодної конфігурації, і називають файл серед непрочитаних посилань, тоді як кожен інший запит, що залежить від конфігурації, відхиляється з цією умовою, називаючи посилання. Засіб, який називає це повідомлення, стосується саме конфігурації: глобальний файл конфігурації — єдина конфігурація, що читається звідусіль, де б вона не зберігалася; її задають через --config або AGGREGA_CONFIG.

Lockfile сутності Release прив’язаний так само — і там, де він читається, і там, де записується. Lockfile поруч із Release читається заради закріплень, щодо яких розв’язуються збірка, pull, перевірка, лінтинг, інспекція, aggrega cache prune і запити редактора та асистента, і він прив’язаний до того самого каталогу, що і його запис: до робочого простору або до власного каталогу Release, якщо Release названо поза ним. Lockfile, що є посиланням за межі, не читається, і кожна з цих операцій зупиняється, називаючи посилання, а не розв’язується щодо закріплень, які зберігаються деінде на машині, чи без них. Засіб, який називає це повідомлення, стосується саме lockfile: у нього одне місце — поруч із Release, де його записує pull.

Файл, що читається поруч із сутністю, обмежується так само. Дві операції читають файл, який лежить поруч із власним документом сутності, а не той, на який указує посилання. Закріплення сутності або її публікація читає кожен інший YAML-документ у каталозі сутності, щоб з’ясувати, чи не ділить його інша сутність. Завантаження сутності Plugin, створеної в каталозі каталогу, читає зібраний .wasm, покладений поруч із нею. Кожен такий файл обмежується каталогом, у межах якого було прочитано власний документ сутності, — робочим простором, названим вами каталогом каталогу поза ним або, для сутності, яку ви закріплюєте чи публікуєте, називаючи її документ поза робочим простором, власним каталогом цього документа, — і файл, що є посиланням назовні, не читається. aggrega pin, aggrega push з --dry-run чи без нього, pull, що закріплює, а також закріплення й публікація в редакторі та асистенті зупиняються з назвою посилання, бо непрочитаний документ може виявитися сутністю, що заважає. Збірка або pull, що завантажує плагін, теж зупиняється з назвою посилання, замість того щоб виконувати байти, що зберігаються деінде на машині, або шукати плагін в іншому місці. Спосіб виправлення, який називає це повідомлення, стосується файлу поруч із сутністю: тримайте там сам файл.

Кеш артефактів робочого простору обмежується так само — як під час читання, так і під час запису. Усе, що читається з кешу в artifact_cache_dir, — кешована сутність, плагін чи бібліотека та маніфест поруч, архів джерела та його метадані, закріплений зовнішній вхід, пакет підпису, локальний пошуковий індекс реєстру — і кожен запис робочого простору, який перелічують aggrega cache status, aggrega cache prune і aggrega cache clear, обмежується каталогом, яким обмежується запис у кеш: самим каталогом кешу, як типовим .aggrega/cache, так і тим, що його називає конфігурація з виходом за корінь робочого простору. Усе в ньому, що є посиланням назовні з каталогу кешу — як в інше місце робочого простору, так і будь-куди ще, — не читається, як і все за каталогом кешу, записаним у межах кореня робочого простору, що сам є посиланням назовні з робочого простору: збірка, pull, валідація, пошук, три команди кешу та запити редактора й асистента, що читають кеш, зупиняються з назвою посилання — включно з вмістом, який кеш зберігає під записаним дайджестом, адже дайджест каже, якими є байти, а не звідки їх можна читати. Каталог кешу, записаний у межах кореня робочого простору, що є посиланням в інше місце робочого простору, читається там, куди веде. Повідомлення про застарівання, яке виводить aggrega inspect і яке нічого не вирішує, не враховується. Prune або clear, натрапивши на власний каталог кешу, що є посиланням назовні з каталогу кешу, або на каталог кешу, що сам є посиланням назовні з робочого простору, сприймає це як видалення, яким воно було б, за умовою «A path the operation writes leads through a link out of the directory it must stay inside (Шлях, у який записує операція, веде через посилання за межі каталогу, в якому має залишатися)», ще до будь-якого переліку. Спосіб виправлення, який називає це повідомлення, стосується кешу: після видалення посилання pull знову заповнить кеш, а кеш, що зберігається деінде, задається через artifact_cache_dir відносно кореня робочого простору, а не через посилання.

Репозиторій, який отримує джерело, обмежується власним checkout. Коли pull — aggrega pull або збірка чи запит редактора або асистента, що розв’язує залежності сутності Release, — отримує джерело git-repository, він робить checkout репозиторію та архівує каталог, який називає джерело, і checkout є окремим каталогом: кожне посилання в репозиторії, включно із самим module_subdir, обмежується ним. Посилання на файл або каталог у межах репозиторію архівується як те, на що воно вказує, під назвою посилання. Посилання назовні з репозиторію — яке може вказувати на будь-який файл на машині, де виконується pull, — не читається: pull зупиняється з назвою посилання та місця, куди воно веде, і нічого не кешується. Checkout — це тимчасовий каталог, що видаляється після зупинки pull, тому повідомлення називає посилання за його місцем у репозиторії — chart/secret.txt, як у першому рядку командного рядка, так і в реченні, — а каталог, у якому воно має залишатися, — як репозиторій і ревізію, які називає джерело: which must stay inside the repository <url> at <ref> (commit <commit>) або at commit <commit>, якщо джерело не називає ref чи називає сам коміт. Місце, куди веде посилання, називається як місце на вашій машині. Спосіб виправлення, який називає це повідомлення, стосується репозиторію: посилання закомічено там, тож і змінювати його треба там — спрямувати всередину репозиторію або замінити самим файлом, — а потім джерело має назвати ревізію з цією зміною. Посилання на каталог, що веде назад у каталог, який архів уже читає через нього, теж зупиняє pull, бо дерево, яке воно представляє, не має кінця; ця відмова є звичайною помилкою, а не цією умовою.

Оверлеї, які читає генерація каталогу, обмежуються так само. aggrega plugin gen-catalog --from-embedded читає кожен оверлей у наданому їй каталозі оверлеїв — указаному через --overlay, вибраному в редакторі або названому асистентом — і обмежує кожен каталогом, у межах якого читається цей каталог оверлеїв: робочим простором для каталогу оверлеїв усередині нього та самим каталогом оверлеїв для названого поза робочим простором. Каталог оверлеїв використовується так, як ви його назвали: якщо він є посиланням, він читається там, куди вказує. Оверлей у ньому, що є посиланням назовні з каталогу, яким він обмежений, не читається, як і посилання на каталог назовні, що може містити власні оверлеї: генерація зупиняється з назвою посилання, нічого не записавши, замість того щоб генерувати без оверлею. Оверлей, що є посиланням в інше місце в межах каталогу, яким він обмежений, читається там, куди вказує; у посилання на каталог усередині нього генерація не заходить. Спосіб виправлення, який називає це повідомлення, стосується оверлею: тримайте сам оверлей у каталозі оверлеїв або назвіть каталогом оверлеїв каталог, що містить усі оверлеї.

Каталог, який ви імпортуєте, обмежується самим собою. aggrega import із каталогом, інструмент імпорту асистента та метод сеансу aggrega/import передають імпортеру файли каталогу, які вибирають його шаблони файлів, кожен під його місцем у каталозі, тож саме цим каталогом обмежуються ці читання, де б він не лежав — як усередині робочого простору, так і поза ним. Оцінюється кожен запис, з якого імпорт щось узяв би: посилання на файл, який вибирає один із відповідних шаблонів — шаблонів імпортера, що обслуговує названий формат, або, якщо формат розпізнається, шаблонів кожного імпортера, з яких вибирає імпорт, включно з основними імпортерами компілятора, — і посилання на каталог, у яке імпорт ніколи не заходить. Посилання, що веде назовні з каталогу — в інше місце робочого простору чи будь-куди ще, — не читається: імпорт зупиняється з назвою посилання ще до відкриття будь-якого файлу каталогу, нічого не записавши. Вибране посилання на файл в іншому місці каталогу читається там, куди вказує, під власною назвою посилання, а посилання на файл, якого не вибирає жоден шаблон, не оцінюється й не читається. Сам каталог використовується так, як ви його назвали: якщо він є посиланням, він читається там, куди вказує. Під час звернення через слухач інструмент асистента називає посилання за його місцем у робочому просторі й нічого не каже про те, куди воно веде. Спосіб виправлення, який називає це повідомлення, стосується імпортованого каталогу: тримайте в каталозі сам файл, а не посилання на нього, або імпортуйте каталог, до якого веде посилання.

Повідомлення, що виводиться. Воно починається з власного речення умови, далі — шлях, до якого дійшло читання, каталог, у якому воно має залишатися, посилання, на яке воно натрапляє дорогою, і місце, куди це посилання веде, а потім — спосіб виправлення:

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 (файл, який читає ця операція, веде через посилання за межі директорії, у якій він має залишатися (читання <workspace>/catalog-local/component/app/1.0.0/component.yaml, що має залишатися в межах <workspace>, посилання <workspace>/catalog-local/component/app/1.0.0/component.yaml веде до <elsewhere>/component.yaml). через це посилання нічого не прочитано. Видаліть посилання або зробіть так, щоб воно вело до місця в межах <workspace>. Щоб прочитати те, що зберігається ззовні, укажіть директорію, яка це містить, як директорію каталогу в конфігурації робочого простору, а не звертайтеся до неї через посилання всередині такої директорії: указана директорія читається там, куди вона веде, навіть якщо вона сама є посиланням)

Діагностика не має категорії: причина помилки — структура на диску, а не будь-який написаний вами документ.

Як виправити: замініть посилання копією того, на що воно веде, або видаліть його; або, якщо сутність має залишатися поза робочим простором, укажіть каталог, що її містить, у catalog_dirs у конфігурації робочого простору чи передайте його через --catalog, щоб цей каталог читався як окремий каталог каталогу сутностей. Указуйте каталог, на який веде посилання, а не той, у якому воно лежить: посилання, знайдене всередині каталогу, оцінюється однаково, хоч би як цей каталог потрапив до читання, тож зазначення його нічого не змінює. Якщо посилання — це сам каталог catalog робочого простору, прийнятий за домовленістю, достатньо вказати catalog — або каталог, на який він указує, — у catalog_dirs чи передати будь-який із них через --catalog, адже названий вами каталог читається там, куди він указує. Якщо посилання — це lock-файл сутності Release, видаліть його й знову виконайте pull для Release, що запише поруч новий lock-файл. Manifest не має рівня каталогу, тому Manifest, який читає Release, зберігається поруч із самою сутністю Release. Якщо посилання — це файл конфігурації, замініть його копією, що зберігається в робочому просторі; конфігурацію, яку ви хочете спільно використовувати між робочими просторами, можна читати, назвавши її глобальним файлом конфігурації через --config або AGGREGA_CONFIG, під власними файлами кожного робочого простору. Якщо посилання лежить поруч із сутністю, яку закріплюють або публікують, замініть його самим файлом або перемістіть документ, що є сутністю, в окремий каталог; якщо це .wasm поруч із сутністю Plugin, покладіть туди сам зібраний .wasm. Якщо посилання — це каталог кешу артефактів або щось у ньому, видаліть його — pull знову заповнить кеш — або, щоб зберігати кеш деінде, задайте в artifact_cache_dir цей каталог, записаний відносно кореня робочого простору (../shared-cache). Якщо посилання закомічене в репозиторії, який отримує джерело git-repository, змініть його в цьому репозиторії — спрямуйте всередину репозиторію або закомітьте сам файл — і вкажіть ревізію, що містить цю зміну. Якщо посилання — це оверлей у каталозі оверлеїв генерації каталогу, замініть його самим оверлеєм або вкажіть як каталог оверлеїв каталог, що містить усі оверлеї. Якщо посилання лежить у каталозі, який ви імпортуєте, зберігайте в каталозі сам файл, а не посилання на нього, або імпортуйте каталог, на який веде посилання.

A reference to another file leads out of the directory it must stay inside (Посилання на інший файл веде за межі каталогу, у якому воно має залишатися)

Сутності Release і Manifest можуть посилатися на інший файл за шляхом: aggregate: і manifest: сутності Release, записані як ./… або ../…, її extends:, extends: сутності Manifest, записаний як шлях, і parameters: { $import: … } сутності Release. Документ у робочому просторі так досягає лише файлів усередині робочого простору. Сутність Release, що лежить поза робочим простором, — та, яку ви називаєте в командному рядку, або та, яку називає конфігурація робочого простору, — і сутність Manifest, яку ви окремо називаєте в командному рядку поза робочим простором, досягають лише файлів у власному каталозі: цей каталог є окремим коренем, як і каталог, який ви називаєте поза робочим простором, і кожна сутність Release, до якої веде її ланцюжок extends:, обмежена тим самим каталогом. Шлях, який у записаному вигляді виходить за межі цього каталогу, і шлях, який у записаному вигляді лишається всередині, але дорогою натрапляє на символьне посилання, що веде назовні, відхиляються обидва, і з файлу, який вони називають, нічого не читається. Шлях, що веде до файлу, якого ще немає в цьому каталозі, тут не відхиляється; про нього повідомляється як про файл, який не вдалося прочитати. Межа робочого простору пояснює, чому обмежується не лише шлях, який ви називаєте, а й посилання.

Те, відносно чого розв’язується шлях, визначає те саме правило, яке довідник мови описує для кожного ключа: aggregate: і manifest: сутності Release та extends: сутності Manifest — поруч із сутністю Release, яку називає команда або запит, або, для сутності Manifest, яку ви називаєте окремо, поруч із цією сутністю Manifest; extends: сутності Release і $import: параметрів — поруч із сутністю Release, яка його записує, тож кожна ланка ланцюжка extends: називає свого батька поруч із собою. Діагностика називає каталог, відносно якого розв’язано шлях.

Ім’я замість шляху тут не перевіряється — aggregate: payments, extends: base-manifest. Його шукають серед документів поруч із сутністю Release, а для сутності Aggregate — і в каталогах каталогу сутностей, на які поширюється правило з «A file the operation reads leads through a link out of the directory it must stay inside (Файл, який читає операція, веде через посилання за межі каталогу, у якому має залишатися)» вище.

Кожна поверхня, що розв’язує те, що вказує сутність Release, зупиняється на цьому ще до читання файлу: aggrega pull, aggrega build, aggrega validate, aggrega inspect для сутності Release чи Manifest, лінтинг однієї сутності Release, а також запити редактора й асистента, які збирають, переглядають, будують граф, перевіряють або описують сутність Release. У редакторі діагностику розміщено на ключі в сутності Release, що привів до файлу.

Повідомлення, що виводиться. Воно починається з речення самої умови, далі йдуть посилання в записаному вигляді, документ, у якому його записано (для extends: і $import: параметрів), каталог, відносно якого його розв’язано, місце, куди воно веде, каталог, у якому воно має залишатися, і посилання, якщо воно виводить назовні; потім спосіб виправлення. Для документа в робочому просторі:

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 (посилання документа на інший файл веде за межі каталогу, у якому воно має залишатися (.spec.aggregate: ../shared/app.yaml, розв’язано відносно <workspace>, веде до <elsewhere>/shared/app.yaml, поза робочим простором <workspace>). з цього файлу нічого не прочитано. Документ у робочому просторі досягає лише файлів усередині <workspace>: перемістіть файл туди — або, якщо посилання виводить назовні, спрямуйте посилання туди — або відкрийте робочий простір у каталозі, що містить обидва документи. Сутність Aggregate, що зберігається поза цим каталогом, досягається за ім’ям, а не за шляхом, із каталогу сутностей, який перелічує конфігурація робочого простору)

а для сутності Release чи Manifest, вказаної поза робочим простором, власний каталог якої і є тим, у якому вона має залишатися:

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 (посилання документа на інший файл веде за межі каталогу, у якому воно має залишатися (.spec.aggregate: ../aggregates/app.yaml, розв’язано відносно <directory>, веде до <parent>/aggregates/app.yaml, поза <directory>, каталогом документа, вказаного поза робочим простором <workspace>). з цього файлу нічого не прочитано. Сутність Release чи Manifest, вказана поза робочим простором — у командному рядку або конфігурацією робочого простору, — досягає лише файлів у власному каталозі <directory>: перемістіть файл туди — або, якщо посилання виводить назовні, спрямуйте посилання туди — або вкажіть документ із робочого простору, що містить обидва документи. Сутність Aggregate, що зберігається поза цим каталогом, досягається за ім’ям, а не за шляхом, із каталогу сутностей, який перелічує конфігурація робочого простору)

з written in <document> після посилання для extends: або $import: параметрів і з the link <link> leads to <place> у кінці, якщо шлях виводить назовні посилання. Посилання aggregate: або manifest: не називає документа: сутність Release, що розширює іншу, могла успадкувати його від сутності Release вище в ланцюжку, і в будь-якому разі воно розв’язується поруч із сутністю Release, яку вказує команда.

Категорія діагностики — [OPS_ERROR]: посилання записано в сутності Release або Manifest.

Як виправити: для сутності Aggregate, що зберігається поза робочим простором, запишіть її metadata.name замість шляху й додайте каталог, що її містить, до catalog_dirs у конфігурації робочого простору або передайте його через --catalog — каталог сутностей є тим способом, у який робочий простір досягає сутностей поза ним. Сутність Manifest, сутність Release, яку вказує extends:, і файл параметрів читаються поруч із сутністю Release і ніколи не шукаються за ім’ям, тож тримайте їх у робочому просторі або відкрийте робочий простір у каталозі, що містить і сутність Release, і файл. Для сутності Release чи Manifest, яку ви вказали поза робочим простором, тримайте те, що вона вказує, у її власному каталозі або збирайте її в робочому просторі, що містить і її, і те, що вона вказує. Якщо шлях виводить назовні посилання, замініть посилання копією того, на що воно веде, або спрямуйте його всередину каталогу.

No catalog version satisfies a version constraint (Жодна версія в каталозі не задовольняє обмеження версії)

Посилання вказує сутність, яка є в каталозі, і закріплює версію, якої в каталозі немає: точну версію, що відсутня, або діапазон із карет, якому не відповідає жодна доступна версія. Це відрізняється від звичайного промаху, коли невідоме саме ім’я: тут сутність існує, і незадовільною є лише версія, тому повідомлення каже саме це, а не повідомляє, що сутність відсутня, змушуючи вас шукати описку в імені.

Усі види доходять до цього через один механізм вибору, тому незадовільне закріплення поводиться однаково, хоч де його записано: описка у версії в зіставленні Recipe сутності Manifest відхиляється так само, як та сама описка в типі компонента.

Ця умова відновлювана, тож редактор може показувати її як діагностику, поки ви продовжуєте вводити текст, а не відмовлятися від документа. У командному рядку вона об’єднується в зупинку.

Повідомлення, яке видається для посилання, до якого доходять залежності сутності Release, — типу компонента чи значення зіставлення в Manifest, — із зазначенням, де його зібрано:

no catalog version satisfies the referenced version constraint: entity "<reference>" (referenced from <referring paths>) (жодна версія в каталозі не задовольняє вказане обмеження версії: вказана сутність і місця, звідки на неї посилаються)

Повідомлення, що виводиться, для закріплення у вказівнику extends::

no catalog version satisfies the referenced version constraint (Component <name>, at .extends, no catalog version satisfies extends parent "<reference>") (жодна версія в каталозі не задовольняє вказане обмеження версії (Component <name>, у .extends, жодна версія в каталозі не задовольняє батька extends “<reference>”))

із Feature замість Component, якщо закріплення містить ланцюжок сутності Feature.

Як виправити: змініть закріплення на версію, яка є в каталозі, або додайте цю версію до каталогу. aggrega inspect перелічує версії, у яких доступна сутність. Діапазон із карет, якому нічого не відповідає, зазвичай означає, що всі доступні версії нижчі за вказану ним нижню межу — розширте діапазон або опублікуйте версію, на яку чекає посилання.

Закріплення, що не має жодної з форм закріплення, — це інша умова, описана в «A version pin is none of the forms a pin takes (Закріплення версії не має жодної з форм закріплення)» нижче.

A version pin is none of the forms a pin takes (Закріплення версії не має жодної з форм, яких набуває закріплення)

Посилання називає іншу сутність і може закріпити потрібну йому версію після двокрапки в одній із двох форм: точне закріплення, тобто семантична версія, наприклад 1.0.0, — форма, якої набуває metadata.version кожної сутності, — або закріплення з кареткою: ^, за яким іде версія, наприклад ^1.0.0, що вибирає найвищу сумісну з нею версію. Закріплення, яке не є жодним із них, — каретка, текст після якої не читається як діапазон версій, як-от ^garbage, або точне закріплення, що не є семантичною версією, як-от 1.x, 1.0 чи v1.0.0, — не називає жодної версії, тож жоден каталог не може містити того, що воно запитує.

Про таке закріплення повідомляється як про некоректне, а не як про сутність чи версію, якої каталог не містить, тож діагностика відсилає вас до набраного тексту, а не до пошуку того, чого не існує. Це та сама умова, хоч би де було записано закріплення: type компонента чи функції, extends: сутності Component або Feature, ключ чи значення відображення сутності Manifest, spec.aggregate сутності Release, implements: сутності Recipe або FeatureRecipe, версія, яку закріплює capability: сутності Recipe під час вибору плагіна, що її обслуговує, і plugin: кроку конвеєра.

Про неї повідомляється там, де повідомляється про посилання, яке не вдалося розв’язати, тож некоректне закріплення ніколи не змінює, які посилання розв’язуються, — воно змінює те, що каже повідомлення про збій. Для коректного закріплення, якому не відповідає жодна доступна версія, лишається умова, про яку для нього повідомляє відповідна поверхня: «No catalog version satisfies a version constraint (Жодна версія в каталозі не задовольняє обмеження версії)» вище або умова «не знайдено» поверхні, на якій його записано.

Закріпленням є лише текст після останньої двокрапки, і лише тоді, коли він не містить /. Тому посилання на хост реєстру з портом, як-от localhost:5000/core/api-server, не містить закріплення — текст після двокрапки порту продовжує посилання — і про нього ніколи не повідомляється як про некоректне.

Повідомлення, що виводиться, для закріплення з кареткою на типі компонента:

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 (посилання містить хибно сформований пін версії (посилання, пін, текст після ^ не є діапазоном версій, місце посилання). запишіть посилання як ім’я, як ім’я з двокрапкою та семантичною версією, наприклад 1.0.0, або як ім’я з двокрапкою та ^ перед версією, щоб вибрати найвищу сумісну з нею версію)

Для точного піна замість частини про caret стоїть an exact pin must be a semantic version. Значення після неї вказує, де записано посилання, словами тієї поверхні, що про нього повідомляє: referenced from і місце в авторському документі, in the Release's spec.aggregate або in the recipe's spec.implements. Там, де зіставлення в Manifest перевіряється щодо implements: його Recipe, перед посиланням натомість ідуть запис зіставлення і те, яка його сторона містить пін (in the mapping key або in the recipe's spec.implements), а для extends: сутності Component або Feature перед ним називаються сутність, що розширює, і поле.

Як виправити: перепишіть закріплення в одній із двох форм або вилучіть його, щоб вибрати найвищу доступну версію. Шаблон, як-от 1.x, записується як закріплення з кареткою, ^1.0.0; версія з початковою v або з менш ніж трьома числами записується повністю, 1.0.0.

Every version a reference could select has been withdrawn (Усі версії, які могло б вибрати посилання, відкликано)

Посилання розв’язується в репозиторій, який є в реєстрі, і всі версії, з яких могло б вибирати виявлення, позначено як відкликані. Не лишилося нічого придатного для вибору.

Про це навмисно не повідомляється як про відсутню сутність. Репозиторій існує і досі містить ці версії; назвати його відсутнім означало б назвати не ту проблему, змусити вас шукати друкарську помилку й виглядало б як тихий відкат, а не як відмова, якою це є. Повідомлення називає кожну відкликану версію з причиною, записаною для неї, тож вам повідомляють саме те, що записав видавець.

Явне зазначення відкликаної версії безпосередньо не спричиняє цієї зупинки. Точна версія повністю оминає виявлення, тож її закріплення — це спосіб свідомо й далі її використовувати; збірка повідомляє про відкликання і продовжує роботу.

Повідомлення, що виводиться:

every published version this reference could select has been withdrawn: <reference>: withdrawn: <version> (<recorded reason>), <version> (<recorded reason>) (усі опубліковані версії, які могло б вибрати це посилання, відкликано: <reference>: відкликано: <version> (<recorded reason>), <version> (<recorded reason>))

Як виправити: прочитайте записані причини — зазвичай вони називають, на що перейти. Перейдіть на те, що замінює відкликану сутність, — саме цього й вимагає відкликання. Якщо поки що мусите зберегти стару, закріпіть у посиланні точну версію: зазначення версії означає, що ви її приймаєте, і тоді збірка щоразу повідомляє про відкликання, а не відмовляє.

A plugins.providers binding names a plugin that does not serve the capability (Прив’язка plugins.providers називає плагін, який не обслуговує цю можливість)

Блок plugins.providers робочого простору вибирає для можливості ідентичність плагіна, і жодна сутність Plugin, що рендерить для провайдера й обслуговує цю можливість, не має такої ідентичності. Прив’язка — це явний вибір, який каталог не може виконати, тож збірка зупиняється, а не тихо переходить на інший плагін: такий відкат відрендерив би ваш вивід через плагін, який ви сказали не використовувати, і нічого б про це не повідомив.

Прив’язка вибирає за координатною ідентичністю плагіна — типом плагіна та його назвою, яку також закріплює lock-файл, — і після неї може містити версію.

Її перевіряють незалежно від того, чи запитує цю можливість якась сутність Recipe. В інших випадках прив’язку читають лише тоді, коли її називає capability: сутності Recipe, тож прив’язку з помилкою в назві можливості ніщо б не використало й ніщо б про неї не повідомило. Тому кожна збірка і кожен aggrega validate --release перевіряє кожну прив’язку, що називає плагін: pull розв’язує таку прив’язку незалежно від того, чи використовує її сутність Recipe, тож збірка має плагін і знає, що він обслуговує, а можливість, якої цей плагін не обслуговує, безперечно хибна. Перевірка читає прив’язки в конфігурації робочого простору, а не lock-файл, і нічого не змінює в тому, який плагін рендерить сутність Recipe, — це лишається за lock-файлом. Прив’язку, що називає плагін, якого збірка не має, — плагін із реєстру, який ще не завантажив жоден pull, — не перевіряють, доки pull його не завантажить. Прив’язку, що не називає плагіна, оцінюють інакше, як рекомендаційну: див. «A provider binding names a capability no plugin the build reads serves (Прив’язка провайдера називає можливість, яку не обслуговує жоден плагін, що його читає збірка)» у розділі «Умови, що не зупиняють збірку» нижче.

Повідомлення, що виводиться, яке додає, що насправді обслуговує названий плагін, і написання на відстані одного редагування, якщо можливість прив’язки така:

plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches: capability "<capability>" is bound to plugin "<plugin-identity>", but no provider-rendering plugin serving "<capability>" matches that identity; "<plugin-identity>" serves "<served capability>", and "<capability>" is one edit from "<served capability>" (запис plugins.providers називає плагін, якому не відповідає жоден плагін рендерингу провайдера, що обслуговує можливість: можливість “<capability>” прив’язано до плагіна “<plugin-identity>”, але жоден плагін рендерингу провайдера, що обслуговує “<capability>”, не відповідає цій ідентичності; “<plugin-identity>” обслуговує “<served capability>”, а “<capability>” за одне редагування від “<served capability>”)

Якщо плагіна, який називає прив’язка, немає в каталозі, що його читає збірка, повідомлення закінчується після «matches that identity», бо про те, що він обслуговує, сказати нічого.

Як виправити: спершу звірте написання прив’язки з власною координатою плагіна — типова помилка полягає в тому, що прив’язка називає можливість там, де мала б назвати плагін. Якщо повідомлення називає можливість за одне редагування від написаної вами, помилка саме в capability: прив’язки. Потім переконайтеся, що плагін є в каталозі, який читає збірка, і що він перелічує цю можливість у spec.provider.capabilities; плагін, який колись обслуговував можливість і більше її не оголошує, дає саме це повідомлення. Вилучення прив’язки — правильне виправлення, якщо можливість обслуговує лише один плагін, бо тоді прив’язці нема чого розрізняти.

No provider plugin version satisfies a Recipe’s provider pin (Жодна версія плагіна провайдера не задовольняє закріплення провайдера в сутності Recipe)

Сутність Recipe прив’язує провайдера із закріпленою версією — helm:1.0.0 або helm:^1.0.0, — і жодна версія сутності Plugin, що рендерить для провайдера, не задовольняє закріплення. Закріплення — це явний запит, тож збірка зупиняється, а не ігнорує його й рендерить через будь-яку версію, що випадково обслуговує провайдера; тихе нехтування закріпленням дало б вивід, якого, згідно з власним оголошенням автора, не має існувати.

До цього призводять дві ситуації, і повідомлення їх розрізняє: можливість не обслуговує взагалі ніщо, або щось її обслуговує, але жодна з його версій не задовольняє обмеження.

Це відрізняється від незадовольнимої версії сутності вище. Та стосується сутності каталогу, названої у версії, якої каталог не містить; ця стосується вибору плагіна, що рендерить можливість.

Повідомлення, що виводяться:

no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no provider-rendering plugin serves it (жодна версія плагіна рендерингу провайдера не задовольняє закріплення версії провайдера в рецепті: можливість “<capability>” закріплює “<version>”, але її не обслуговує жоден плагін рендерингу провайдера) no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no serving plugin version satisfies it (жодна версія плагіна рендерингу провайдера не задовольняє закріплення версії провайдера в рецепті: можливість “<capability>” закріплює “<version>”, але жодна версія плагіна, що її обслуговує, не задовольняє його)

Як виправити: розширте або виправте закріплення в полі capability: сутності Recipe або додайте до каталогу версію плагіна, яку воно запитує. Закріплення з кареткою відповідає версіям, не нижчим за нижню межу, в межах тієї самої мажорної версії, тож закріплення ^2.0.0 не задовольняє плагін 1.x, хоч би яким новим він був. Якщо повідомлення каже, що можливість ніщо не обслуговує, проблема не в закріпленні: плагіна немає взагалі, і вилучення закріплення не допоможе.

No plugin advertises a requested parse or import format (Жоден плагін не оголошує запитаний формат розбору чи імпорту)

Було запитано формат, і жоден плагін його не оголошує. Два сокети, що маршрутизують за форматом, мають кожен власну умову, і вони відрізняються лише тим, яку роботу запитано: плагін-парсер читає сторонній формат джерела, а плагін-імпортер перетворює сторонній вміст на сутності Aggrega.

Простір форматів відкритий і повністю належить плагінам. Жоден сокет не містить списку форматів, відомих компілятору: плагін оголошує формати, які обробляє, як можливості, а новий формат постачається як новий плагін без змін у компіляторі. Тому ця зупинка повідомляє про оголошений набір у його поточному стані, а не про фіксований перелік, і кожен промах явний: запит або має того, хто його оголошує, або його не можна виконати. Ніщо не заступає відсутній плагін, за єдиним винятком — парсерів, вбудованих у компілятор, — який описано нижче.

Повідомлення, що виводяться:

no parser plugin advertises the requested format: no parser plugin advertises "parse:<format>" (жоден плагін-парсер не оголошує запитаний формат: жоден плагін-парсер не оголошує “parse:<format>”) no importer plugin advertises the requested format: no importer plugin advertises "import:<format>" (жоден плагін-імпортер не оголошує запитаний формат: жоден плагін-імпортер не оголошує “import:<format>”)

Єдиний плагін-парсер, що оголошує формат, але має форму версії, яку неможливо розв’язати, вважається відсутнім оголошувачем, а не тихим пропуском, і про це повідомляється:

no parser plugin advertises the requested format: no parser plugin version resolves for "parse:<format>" (жоден плагін-парсер не оголошує запитаний формат: для “parse:<format>” не розв’язується жодна версія плагіна-парсера)

Розбір переходить на парсери, вбудовані в компілятор. Збірка розбирає кожен файл, який вона передає політиці render-verdict і формат якого ця політика не читає нативно, імпортер читає своє джерело через парсер для синтаксису, який він називає, а імпорт, що не називає формату, розбирає джерело в синтаксисі, який називає кожна застосовна сигнатура. Для кожного синтаксису використовується парсер, який обслуговує каталог робочого простору, а якщо каталог не обслуговує жодного — парсер, вбудований для нього в сам компілятор, серед них парсер HCL, через який збірка читає вивід Terraform, і парсер JSON, через який читають базові імпортери компілятора, тож ні політика щодо виводу Terraform, ні імпорт через базовий імпортер не потребують парсера в каталозі. Якщо каталог обслуговує парсер для синтаксису, власний парсер компілятора не бере участі, а два парсери з різними назвами в каталозі відхиляються, як описано в A parse or import format is advertised by more than one plugin (Формат розбору чи імпорту оголошує більше ніж один плагін). Тож ця зупинка називає синтаксис, для якого парсера не обслуговує ні каталог, ні компілятор.

Як виправити: переконайтеся, що формат написано так, як його оголошує плагін, — можливість складається з префікса сокета й назви формату, тож плагін, що оголошує parse:hcl, обслуговує формат hcl і більше нічого. Потім переконайтеся, що плагін є в каталозі, який читає збірка. Якщо плагіна для формату не існує, бракує саме цього плагіна; компілятор не може читати формат, якого ніхто не оголошує.

A parse or import format is advertised by more than one plugin (Формат розбору чи імпорту оголошує більше ніж один плагін)

Два чи більше різних плагінів оголошують той самий формат, і запит неможливо маршрутизувати, не вгадуючи, який із них використати.

Каталог, що містить обидва, коректний і завантажується без зауважень. Два видавці можуть кожен постачати парсер чи імпортер для одного формату, і об’єднання їхніх каталогів — підтримуваний сценарій. Неоднозначність — це умова в точці використання: зупинка відбувається, коли спірний формат справді запитано, тож конкуруюча пара поза досяжністю збірки ніколи її не блокує.

Називаються всі кандидати, у відсортованому порядку, тож повідомлення однакове під час кожного запуску.

Повідомлення, що виводяться:

format is advertised by more than one parser plugin: format "<format>" is advertised by parser plugins [<plugin-names>] (формат оголошує більше ніж один плагін-парсер: формат “<format>” оголошують плагіни-парсери [<plugin-names>]) format is advertised by more than one importer plugin: format "<format>" is advertised by importer plugins [<plugin-names>] (формат оголошує більше ніж один плагін-імпортер: формат “<format>” оголошують плагіни-імпортери [<plugin-names>])

Для імпортера зупинка виникає ще в одній формі: записи plugins.importer робочого простору приєднують більше ніж один з імпортерів, що оголошують формат, і тоді названі імпортери — це приєднані.

Імпортери, з яких вибирає імпорт, — це ті, що є в каталозі робочого простору, і базові імпортери компілятора, які оголошують свої формати в кожному робочому просторі. Тож каталог, що містить власний імпортер з іншою назвою для формату, який обслуговує базовий імпортер, — import:langflow або import:flowise, — натрапляє на цю зупинку під час імпорту, що не приєднує жодного з них, і повідомлення називає базовий імпортер поряд з імпортером каталогу. Імпортер, який каталог містить під власною назвою базового імпортера, не є другим оголошувачем: у межах однієї назви вибирається найвища версія, і версія, що дорівнює власній версії базового імпортера, з модулем поруч, працює замість нього. Імпортер без модуля поруч не є кандидатом там, де формат оголошує імпортер із цією назвою, здатний працювати, як описано в розділі Який із них виконується поруч із вашими власними імпортерами.

Як виправити: для імпортера залиште обидва в каталозі — або залиште свій поряд із базовим імпортером — і приєднайте потрібний: запис plugins.importer, чий uri називає його за ідентичністю та версією, uri: importer/<name>:<version>, як його записує aggrega plugin add importer. Приєднаний імпортер вибирається серед тих, що оголошують формат, так само як запис plugins.providers вибирає серед плагінів, що обслуговують можливість на сокеті провайдера, як описано в «A capability is served by more than one provider plugin (Можливість обслуговує більше ніж один плагін провайдера)» нижче. Якщо названі імпортери приєднують ваші записи, залиште запис для потрібного й вилучіть інший. Сокет розбору такого вибору не має, тож для парсера рішення — звузити каталог, який читає збірка, щоб у ньому був лише потрібний плагін; найпростіше — спрямувати --catalog на каталог, що містить ваш вибір.

A plugins.importer entry pins a version of its importer the catalog does not hold (Запис plugins.importer закріплює версію свого імпортера, якої немає в каталозі)

Запис plugins.importer підключає імпортер за його ідентичністю та версією — точною, uri: importer/<name>:1.2.0, або діапазоном, uri: importer/<name>:^1.2.0, — і цей імпортер оголошує формат, який запитує імпорт, але жодна з його версій, серед яких обирає імпорт, не задовольняє закріплення. Це версії, які містить каталог робочого простору, а для основного імпортера — також власна версія компілятора: точної версії немає або жодна з версій не потрапляє в діапазон. Версія — це явний вибір, тому імпорт відхиляється ще до запуску будь-якого імпортера, а не запускає замість нього іншу версію імпортера.

Це відрізняється від випадку, описаного вище, коли жоден імпортер не оголошує формат: тут імпортер є одним із тих, серед яких обирає імпорт, і оголошує формат, а бракує лише версії, яку називає запис. Закріплення, що не має жодної з форм закріплення версії, як-от :latest, натомість повідомляється як некоректне, як описує «A version pin is none of the forms a pin takes (Закріплення версії не має жодної з форм закріплення)».

Повідомлення, що виводиться, із назвою можливості формату та версією, яку закріплює запис:

no importer plugin version satisfies the plugins.importer entry’s version pin: capability "import:<format>" pins "<version>" but no serving plugin version satisfies it

Як виправити: змініть версію в uri запису на ту, яку містить каталог (для основного імпортера такою є й власна версія компілятора), або розширте діапазон, або додайте до каталогу версію, яку називає запис. Діапазон із карет відповідає версіям, не нижчим за його нижню межу в межах тієї самої мажорної версії, тому ^2.0.0 не задовольняє імпортер 1.x, хоч би яким новим він був.

A plugin reference carries a registry host or an artifact path (Посилання на плагін містить хост реєстру або шлях до артефакту)

Посилання на сутність Plugin починається із сегмента у формі хоста реєстру (такого, що містить крапку або двокрапку, як DNS-ім’я чи пара «хост і порт») або зі шляху до артефакту. До сутності Plugin звертаються за її координатною ідентичністю: тип плагіна, скісна риска, ім’я та, за потреби, версія. Під час отримання ця ідентичність прив’язується до фізичного розташування додаванням префікса з налаштованого реєстру та самого шляху до плагіна, тож посилання, яке вже містить такий префікс, отримало б його двічі й було б прив’язане до розташування, з якого неможливо отримати артефакт.

Посилання відхиляється там, де формується розташування, а не під час отримання, тож повідомлення називає те, що ви написали, а не з’являється пізніше як незрозуміла помилка тегу.

Повідомлення, що виводиться, у рамці отримання, яке формувало розташування, зі способом виправлення в рядку нижче:

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>" 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

Як виправити: приберіть усе перед типом плагіна, залишивши лише координату: provider/helm:1.0.0, а не hub.example.com/plugin/provider/helm:1.0.0. Реєстр, з якого збірка отримує артефакти, є конфігурацією робочого простору, а не частиною ідентичності. Саме це дає змогу обслуговувати один каталог із кількох реєстрів без редагування сутностей у ньому.

A plugin or recipe reference carries no scope (Посилання на плагін або рецепт не містить області)

Посилання на сутність Plugin або Recipe не має початкового сегмента області: скісної риски немає взагалі або перед нею порожньо, як у /name. Обидва види ідентифікуються двома частинами, і саме перша розрізняє дві однойменні сутності: Plugin — за типом плагіна та ім’ям, Recipe — за провайдером та ім’ям. Два сокети можуть мати по плагіну з назвою redact, а два провайдери можуть постачати по рецепту з назвою postgres, тож область є частиною ідентичності, а не прикрасою до неї.

Розташування, побудоване з порожньої області, містить порожній сегмент шляху (подвійну скісну риску), який неможливо розв’язати. Тому посилання відхиляється там, де формується розташування, а не залишається, щоб пізніше завершитися помилкою як незрозуміле отримання.

Два способи виправлення протилежні випадку кваліфікованого плагіна вище і один одному, тому кожен сформульовано окремо: тут посиланню бракує сегмента, і ви його додаєте, тоді як кваліфіковане посилання містить зайвий сегмент, і ви його прибираєте.

Повідомлення, що виводяться, кожне в рамці отримання і з власним способом виправлення нижче:

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>" 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

catalog: tier-3 pull <uri>: recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location: "<identity>" remediation: no local catalog directory held this reference, so it was looked for in the registry, where a provider segment is required; re-run as aggrega pull --release <release> --catalog <dir> so the directory that holds it is searched first (--catalog is repeatable)

Як виправити: для плагіна додайте як префікс тип плагіна, який сутність Plugin оголошує в metadata.pluginType. Для рецепта додайте як префікс провайдера, якого сутність Recipe оголошує в spec.capability. Спосіб виправлення для рецепта називає ще одну можливість, на яку варто зважити: якщо пошук узагалі дійшов до реєстру, це означає, що спершу було переглянуто локальні каталоги і жоден із них не містив посилання. Тож якщо рецепт має надходити з локального каталогу, спрямуйте збірку на цей каталог, а не додавайте область.

The build consumes an artifact its publisher has deprecated (Збірка використовує артефакт, який його видавець позначив як застарілий)

Посилання, яке розв’язує ця збірка, має позначку застарілості, записану видавцем, і рівень серйозності цієї позначки дорівнює порогу зупинки, налаштованому в робочому просторі, або перевищує його. Позначку додають до опублікованого артефакту згодом, тому артефакт, який учора збирався без помилок, сьогодні може її мати, хоча у ваших власних файлах нічого не змінилося.

Повідомлення і зупинка — окремі речі, і налаштовується лише зупинка. Про кожну записану позначку повідомляється на будь-якому рівні серйозності, і жодне налаштування цього не вимикає. Чи зупиняє позначка ще й збірку, вирішує halt_on_deprecated_severity, порівнюючи записаний рівень серйозності з налаштованим порогом у порядку warning < error < retracted. Якщо поріг не налаштовано, ніщо не зупиняє збірку, і кожна позначка є лише попередженням. Рівень серйозності поза цими трьома, як і поріг поза ними, ніколи не спрацьовує: некоректне значення не може ні спричинити зупинку, ні запобігти їй.

Кожне сповіщення виводиться до зупинки збірки, а не лише те, що її зупинило, тож підвищення порогу ніколи не приховує від вас жодної знахідки — сама зупинка називає те єдине посилання, на якому вона сталася. Знахідки впорядковано за посиланням, тож той самий lockfile щоразу дає ту саму послідовність, і зупиняє завжди та сама знахідка.

Перевіряються два сховища, і обидва повідомляють однаково: посилання, закріплені в lockfile, і плагіни, записані як довірені для вердикту «прийняти чи відхилити». Жодна з перевірок не звертається до реєстру — обидві читають уже записане, — тож збірка лишається ahead-of-time.

Повідомлення, що виводиться. Кожна знахідка виводиться під час обходу, а потім зупинка повторює ту, що досягла порогу, і називає налаштування, яке зупинило збірку:

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"

Позначка одного з двох рівнів-попереджень подається як deprecated (warning) або deprecated (error) замість retracted. Цю різницю збережено, бо ці рівні означають різне — не рекомендовано, але ще можна вибрати, проти вилучено з вибору, — і подати сильніший як слабший означало б применшити те, що сталося.

Як виправити: прочитайте записане повідомлення — це власне пояснення видавця, на що перейти, — і виконайте міграцію. Якщо мігрувати поки неможливо, підвищення halt_on_deprecated_severity — або його скидання — знову перетворює зупинку на попередження, яке ви й далі бачитимете; це свідоме прийняття, а не обхідний шлях, і сповіщення й надалі виводиться. Позначка, записана для версії, яку ви більше не використовуєте, зникає, коли lockfile оновлюють за допомогою aggrega pull.

A trusted plugin’s recorded digest disagrees with the cached artifact (Записаний дайджест довіреного плагіна не збігається з кешованим артефактом)

Для плагіна, приєднаного в ролі, що приймає або відхиляє збірку, записано дайджест як довірений, а кешований маніфест плагіна повідомляє інший. Їх порівнюють до того, як буде прочитано виконуваний файл плагіна, і розбіжність зупиняє розв’язання на цьому етапі.

Саме це порівняння робить записаний дайджест авторитетним джерелом, а не повторенням. Без нього байти плагіна перевіряються лише щодо закріплення, виведеного з того самого маніфесту, чиї байти воно потім і перевіряє, — узгоджено за побудовою, але нездатно помітити, що весь артефакт замінено. Порівняння записаного з тим, що маніфест повідомляє тепер, і дає цій перевірці зовнішню точку зору.

Це відрізняється від невідповідності дайджесту вмісту, яка повідомляє, що розв’язані байти не збігаються із заявленим для них дайджестом. Тут нічого не прочитано, і байти цілком можуть збігатися з маніфестом; розбіжність полягає в тому, який саме артефакт розв’язується. Розрізняти ці випадки важливо, бо способи виправлення протилежні: в одному випадку артефакт пошкоджено або підроблено, в іншому плагін змінено легітимно, але його нову ідентичність ще не переглянуто.

Повідомлення, що виводиться:

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

Як виправити: з’ясуйте, що змінилося, перш ніж щось перезаписувати, — це плагін, який може відхиляти ваші збірки, а записаний дайджест є свідченням того, що хтось його переглянув. Якщо зміна очікувана, бо ви свідомо оновили плагін, перегляньте новий артефакт і перезапишіть для нього довірений дайджест. Якщо ні — відновіть артефакт, названий у записі; розбіжність свідчить, що ідентичність змінилася без чийогось рішення.

Ланцюжок extends: неможливо зібрати

Ланцюжок extends: сутності Component, Feature, Manifest або Release називає батьківську сутність, яку неможливо розв’язати, тому ланцюжок не вдається перетворити на одну розв’язану сутність.

Ця умова відрізняється від циклу, який має власну умову і власний спосіб виправлення, — див. «Cyclic extends chain» вище; від ланцюжка, що перевищує межу глибини, який має власну умову нижче; і від незадовольнимої фіксації версії, коли батьківська сутність існує, а не існує лише версія.

Повідомлення, що виводиться, називає сутність із нерозв’язним extends: і посилання, яке вона оголошує:

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 (не вдалося злиття успадкування (Component <name>, у .spec.extends, entity розширює reference, якого не надає жодна сутність каталогу). Перевірте, що посилання extends називає сутність, присутню в каталозі)

Коли перевірка, що про це повідомляє, читає батьківську сутність із кешу артефактів за закріпленням lockfile — перевірка extends збірки та aggrega validate --release, aggrega validate для всього каталогу й aggrega inspect, а також ті самі перевірки, запущені з редактора та з інструмента validate асистента, — порада далі називає pull: «a base published to a registry is fetched by aggrega pull --release <release>» (базу, опубліковану в реєстрі, отримують зазначеною командою). Валідація одного файлу сутності не читає lockfile, тож pull не змінив би нічого з того, що вона читає, і її повідомлення закінчується на каталозі.

Feature з’являється замість Component, коли збій стався в ланцюжку сутності Feature. Як і у випадку з циклом, першою названо сутність, з якої почалося розв’язання, а сутність, названа в ребрі, — це та, рядок extends: якої слід відкрити; у багаторівневому ланцюжку це різні сутності.

extends: сутності Manifest розв’язується відносно іншого місця, тому й порада для нього інша. Manifest — це конфігурація оператора, створена поруч із сутністю Release, а не вміст каталогу, і його extends: називає файл за відносним шляхом або metadata.name сутності Manifest у власному каталозі сутності Release — ніколи не сутність каталогу. Тому його повідомлення завершується тим, у що посилання не вдалося розв’язати, і тим, де шукати натомість:

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 (не вдалося злиття успадкування (Manifest <name>, у .spec.extends, entity розширює reference, яке не вдалося розв’язати: what looking produced). Перевірте, що посилання extends є відносним шляхом або іменем сутності Manifest у каталозі сутності Release)

Ця кінцева деталь — збій, про який повідомив сам пошук: файл, який не вдалося прочитати, або сканування, що не проіндексувало жодної сутності Manifest під цим іменем, — тож зазвичай вона вказує, яку з двох форм було випробувано і чому результат порожній.

extends: сутності Release розв’язується відносно каталогу і приймає одну форму. Release називає свою батьківську сутність відносним шляхом — ./base-release.yaml або ../shared/base-release.yaml. Каталог, відносно якого він розв’язується, — це каталог, що містить сутність Release, яка записує посилання, і кожна ланка ланцюжка розв’язується відносно власного каталогу — тож проміжна сутність Release, що зберігається в підкаталозі, називає свою батьківську сутність поруч із собою, незалежно від того, де лежить сутність Release, яку називає команда. Простий токен не є шляхом і не називає сутність Release, яку шукатиме компілятор, тому про нього повідомляється тут, а не шукається там, де його неможливо знайти:

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 (не вдалося злиття успадкування (Release <name>, у .spec.extends, entity розширює reference, яке не вдалося розв’язати: what looking produced). Перевірте, що посилання extends є відносним шляхом до файлу сутності Release, наприклад ./base-release.yaml, який розв’язується від каталогу, що містить цю сутність Release)

Як виправити: для сутності Component або Feature переконайтеся, що значення extends: називає сутність, яка є в каталозі, написану так само, як власне metadata.name цієї сутності, — з урахуванням регістру. Базу, опубліковану в реєстрі, читають із кешу артефактів за закріпленням, яке lockfile сутності Release записує для неї, тож якщо база розташована в реєстрі, виконайте aggrega pull --release <release>: pull проходить ланцюжком, отримує базу й закріплює її. Для сутності Manifest переконайтеся, що файл розташований там, куди вказує відносний шлях, або що сутність Manifest із таким metadata.name лежить у каталозі сутності Release і розбирається. Для сутності Release переконайтеся, що значення починається з ./ або ../ і що файл, на який воно вказує, існує і розбирається як Release.

Ланцюжок extends: перевищує межу глибини

Ланцюжок extends: сутності Component, Feature, Manifest або Release завершується коректно, але проходить через більше сутностей, ніж дозволяє межа в десять.

Ця ситуація має власну умову, а не спільну з наведеною вище, бо два способи виправлення не мають нічого спільного: відсутня батьківська сутність — це посилання, яке слід виправити, а надто глибокий ланцюжок — це структура, яку слід сплощити. Межа захищає від випадкової помилки під час написання, а не є структурним обмеженням: архітектори зазвичай розширюють базову сутність на один-два рівні, а ланцюжок глибиною десять — це зазвичай базове дерево, яке розрослося, а не свідомий задум.

Її досягає лише ланцюжок, який ЗАВЕРШУЄТЬСЯ. Про ланцюжок, що замикається сам на себе, повідомляється як про цикл, незалежно від його довжини, тож ця умова ніколи не підміняє цикл, і її порада — скоротити ланцюжок — ніколи не дається для циклу.

Повідомлення, що виводиться, називає межу і довжину, якої досяг ланцюжок:

extends chain exceeds maximum depth (Component <name>, rule extends). the bound is 10 and this chain reaches <length>; shorten the chain, or extend a base that sits closer to its root (ланцюжок extends перевищує максимальну глибину (Component <name>, правило extends). межа — 10, а цей ланцюжок досягає <length>; скоротіть ланцюжок або розширте базову сутність, розташовану ближче до кореня)

Feature, Manifest або Release з’являється замість Component, коли збій стався в одному з цих ланцюжків. Межа однакова — десять — для кожного виду, що оголошує extends, і вона рахує сутності в ланцюжку, а не ланки між ними: ланцюжок рівно з десяти сутностей збирається, а про одинадцяту сутність і повідомляє ця умова. Отже, сутність, що розширює базову, яка розширює базову, — три сутності, дві ланки — досягла трьох.

Як виправити: згорніть середину ланцюжка. Такий глибокий ланцюжок зазвичай означає, що кожен рівень додає небагато, і злиття кількох рівнів в одну базову сутність — це водночас і виправлення, і зрозуміліша структура. Якщо рівні справді різні, сутність нижче в ланцюжку може безпосередньо розширювати базову сутність ближче до кореня, замість успадковувати через кожен проміжний рівень. Такий глибокий ланцюжок сутностей Manifest — це зазвичай стек накладань для окремих середовищ: злийте рівні, які ніхто не змінює, з базою, на яку вони накладаються.

Ім’я твердження оголошено двічі в ланцюжку extends:

Сутність і те, що вона розширює, обидві оголошують твердження під тим самим іменем, і ці два оголошення задають різні правила. Твердження сутності, що розширює, додаються до тверджень базової; вони ніколи не замінюють жодного з них. Тож ім’я, оголошене двічі з двома різними правилами, непомітно скасувало б інваріант базової сутності, а це протилежне тому, для чого розширюють сутність.

Оголошення того самого імені з ідентичним правилом не є колізією і збирається. Саме це робить перевірку ідемпотентною вздовж ланцюжка: без цього ланцюжок глибиною три щоразу конфліктував би з власним середнім рівнем.

Порядок є частиною контракту, а не випадковістю. Твердження обчислюються в об’єднаному порядку, і перше хибне зупиняє збирання, тож інваріант базової сутності перевіряється раніше за інваріант нащадка, а вздовж ланцюжка набір накопичується від кореня вниз.

Повідомлення, що виводиться:

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 (ім’я твердження оголошено двічі вздовж ланцюжка extends (Component <name>:<version>, правило assertions, у .spec.assertions.<key>). твердження «<key>» вже оголошено в базовій сутності Component «<base>» з іншим правилом; перейменуйте твердження сутності, що розширює; твердження сутності, що розширює, доповнюють твердження базової і ніколи їх не замінюють)

Як виправити: перейменуйте твердження сутності, що розширює, яке повідомлення називає разом із базовою сутністю, що вже його оголошує. Якщо ви хотіли замінити правило базової сутності, розширення цього не підтримує — звузьте твердження базової сутності так, щоб воно виконувалося для кожної сутності, що її розширює, або перенесіть правило вниз на сутності, яким воно справді потрібне. Якщо два правила мають бути однаковими, зробіть їх текстуально ідентичними, і колізія зникне.

Release маршрутизує компоненти свого Aggregate одним із двох способів: іменованими межами в boundaries: або компонентами верхнього рівня в components:. Ці способи взаємовиключні, і окремий документ, що оголошує обидва, відхиляється під час читання. Ця умова — те саме правило в ланцюжку extends:: базовий документ, що оголошує іменовані межі, і дочірній, що оголошує компоненти верхнього рівня, кожен окремо коректні, і лише їх злиття зводить два вибори в один розв’язаний Release.

Жоден документ сам по собі не помилковий, тому повідомлення називає обидва і обидва ключі. Діагностика, що називала б лише Release, на який вказали збирання, відправила б вас до файлу, у якому немає жодної помилки.

Ланцюжка, ланки якого погоджуються, це не стосується. Кожна ланка з іменованими межами компонується звичайно, як і кожна ланка з компонентами верхнього рівня. Зупиняє саме їх змішування.

Повідомлення, що видається, називає два файли й ключ, який оголошує кожен:

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>") (ланцюжок extends релізу поєднує і іменовані межі, і компоненти верхнього рівня: оголосіть одну форму маршрутизації для всього ланцюжка, ніколи обидві; зазначаються файл Release, файл, що оголошує межі, і файл, що оголошує компоненти)

Як виправити: виберіть форму маршрутизації, яку має використовувати ланцюжок, і дотримуйтеся її до кінця. Якщо базовий документ оголошує іменовані межі, дочірній, що хоче налаштувати компоненти, звертається до них усередині межі, яка їх містить, а не в корені Release, — саме це й дає змогу змінити розміри одного компонента, не повторюючи топологію. Якщо базовий документ оголошує компоненти верхнього рівня, дочірній, якому потрібні іменовані межі, описує іншу форму маршрутизації, ніж його базовий, і його краще створити як окремий Release, а не як дочірній для того.

An external input’s URL uses a scheme that is not allowed (URL зовнішнього входу використовує недозволену схему)

URL, на який вказує сутність, використовує схему поза дозволеним набором. Дозволено три: https; http, але лише до loopback-хоста, тож незашифрований трафік може досягти тільки локальної машини; і oci — для вмісту, що завантажується з реєстру.

Повідомлення, що виводяться, для URL http не до loopback-хоста та для будь-якої іншої схеми:

externalinputs: "<url>": plain http is allowed for loopback hosts only (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed (externalinputs: для цього URL звичайний http дозволено лише для loopback-хостів (дозволені схеми: https, http до loopback-хоста, oci): externalinputs: схема URL не дозволена) externalinputs: "<url>": scheme "<scheme>" is not allowed (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed (externalinputs: для цього URL вказана схема не дозволена (дозволені схеми: https, http до loopback-хоста, oci): externalinputs: схема URL не дозволена)

Як виправити: змініть URL на https або на oci, якщо вміст опубліковано в реєстрі. Звичайний URL http до віддаленого хоста відхиляється, а не понижується, тож виправлення — перевести його на захищену схему; локальний сервер розробки й далі працює через http, бо loopback-хост дозволено.

A render requests an external input the lockfile does not pin (Рендеринг запитує зовнішній вхід, не закріплений у lockfile)

Щось, потрібне збірці, завантажується з URL, який lockfile не закріплює. Збірка рендерить замикання, записане в її lockfile, і нічого не завантажує, тому немає налаштування, яке дозволило б цьому запуску натомість отримати URL: саме заморожене замикання робить збірку відтворюваною, а непомітне розширення набору входів — єдине, чого вона робити не повинна.

Тому ця зупинка інформативна, а не є помилкою конфігурації. Закріплення були повними, коли сутність Release розв’язувалася, тож незакріплений URL тепер означає, що відтоді щось змінилося: значення, яке визначає, які посилання запитує рендеринг, чарт, що почав вказувати на нове місце, або lockfile, розв’язаний для іншої сутності Release.

Повідомлення, що виводиться:

"<url>" is not pinned in the lockfile; run aggrega pull --release <release> to pin every external input this Release’s render consumes, then build again: externalinputs: acquisition is disabled for unpinned inputs (цей URL не закріплено в lockfile; виконайте aggrega pull —release із шляхом до сутності Release, щоб закріпити кожен зовнішній вхід, який споживає рендеринг цієї сутності Release, а потім зберіть знову: externalinputs: отримання вимкнено для незакріплених входів)

Як виправити: закріпіть вхід. aggrega pull --release <path> рендерить сутність Release, щоб з’ясувати, які зовнішні входи вона споживає, завантажує кожен і записує його дайджест у lockfile поруч із закріпленнями залежностей — після цього кожна наступна збірка отримує його із закріпленого запису й зовсім не потребує мережі. Якщо URL новий, бо щось, що ви написали, почало на нього вказувати, пропущеним кроком є повторне розв’язання сутності Release; якщо ж він неочікуваний, варто знайти посилання, яке його додало, перш ніж закріплювати.

Fetched bytes do not match a pinned digest (Завантажені байти не відповідають закріпленому дайджесту)

Закріплений URL було завантажено знову — бо його збережена копія була відсутня, — і отримане не відповідає тому, що закріпив lockfile. Записаний дайджест завжди має перевагу: у сховище нічого не записується, і жодні байти не повертаються.

Повторне заповнення завантажується за записаним дайджестом, а не за тегом URL, тож тег, переміщений на інший вміст, не може змінити того, що віддає закріплений запис. Отже, ця зупинка означає, що вміст за самим дайджестом не повернувся цілим.

Повідомлення, що виводяться, для вмісту, завантаженого з реєстру, та для вмісту, завантаженого через HTTPS:

externalinputs: "<url>": refilled manifest digest is <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest (externalinputs: для цього URL дайджест повторно отриманого маніфесту відрізняється від закріпленого дайджесту: externalinputs: отримані байти не відповідають закріпленому дайджесту) externalinputs: "<url>": refetched bytes hash to <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest (externalinputs: для цього URL хеш повторно отриманих байтів відрізняється від закріпленого дайджесту: externalinputs: отримані байти не відповідають закріпленому дайджесту)

Як виправити: спершу розглядайте це як питання ланцюга постачання, а не як lockfile, який треба оновити: закріплення стверджує, що саме ці байти були тим, з чим ви збирали, а відмова — це те, що твердження виконується. Переконайтеся, що джерело досі публікує вміст, названий дайджестом, і перевірте, чи щось між вами та джерелом не переписує відповіді; поширена причина — проксі чи дзеркало, що віддає підміну. Лише коли ви знаєте, що змінилося, і приймаєте це, закріпіть заново за допомогою aggrega pull, що запише новий дайджест.

A stored external input no longer matches its record (Збережений зовнішній вхід більше не відповідає своєму запису)

Закріплений вхід було прочитано з локального сховища, і він не відповідає закріпленому для нього запису. Перевірка виконується під час кожного читання, до віддачі байтів, тож пошкоджене або підроблене сховище виявляється в момент використання, а не непомітно живить збірку.

Що саме порівнюється, залежить від того, як закріплено вхід. Вміст, завантажений через HTTPS, закріплюється хешуванням корисного навантаження, тож під час кожного читання він хешується знову, і повідомляються обидва дайджести. Вміст, завантажений з реєстру, закріплюється дайджестом маніфесту, який фіксує корисне навантаження через власний маніфест реєстру, а не прямим хешуванням, тож збережена копія перевіряється за записаним розміром — повна перевірка дайджесту натомість відбувається під час отримання та кожного повторного заповнення за дайджестом.

Повідомлення, що виводяться:

externalinputs: "<url>": store blob sha256 is <digest>, pinned digest is <digest>: externalinputs: store blob mismatches its pinned record (externalinputs: для цього URL sha256 blob у сховищі відрізняється від закріпленого дайджесту: externalinputs: blob у сховищі не відповідає своєму закріпленому запису) externalinputs: "<url>": store blob sha256/<digest> is <n> bytes but the pinned record says <n>: externalinputs: store blob mismatches its pinned record (externalinputs: для цього URL розмір blob у сховищі в байтах відрізняється від розміру в закріпленому записі: externalinputs: blob у сховищі не відповідає своєму закріпленому запису)

Як виправити: видаліть проблемний блоб зі сховища й дозвольте наступному запуску заповнити його з джерела; перед будь-яким записом він перевіряється за записаним дайджестом. Якщо після цього повторне заповнення теж повідомляє про невідповідність дайджесту, розбіжність виникає вище за течією, а не локально, і читати слід розділ вище. Звичайна локальна причина — сховище, спільне для кількох машин, або відновлене з резервної копії, зробленої посеред запису.

A guard needs a catalog entity the build resolved and cannot see (Перевірці потрібна сутність каталогу, яку збірка розв’язала, але не бачить)

Семантична перевірка звернулася до сутності каталогу за типом компонента, а сутність відсутня в поданні, яке отримала перевірка, — хоча розв’язання розв’язало цей тип як посилання на каталог. Справді нерозв’язне посилання зупиняє збірку раніше, під час розв’язання, тож якщо перевірка не знаходить сутність, розв’язаний набір збірки та подання перевірки розійшлися.

Збірка зупиняється, а не пропускає перевірку. Пропуск скасував би перевірку без жодного сповіщення про це, і компоненти, яких вона стосувалася, пройшли б неперевіреними, поки збірка звітувала б про успіх.

Тип, записаний як відносний шлях — що починається з ./ або ../, — тут не оцінюється: тип ніколи не читається як файл, тож таке значення взагалі не називає сутності каталогу й відхиляється раніше, під час розв’язання залежностей сутності Release, як посилання, якого немає в жодному каталозі. До цієї зупинки доходить лише посилання на каталог у вигляді простого токена.

Хоч би де виникла ця умова, повідомлення має однаковий текст, тож воно називає тип і помилку, а не перевірку, яка її виявила.

Воно також не називає жодного документа й жодного ключа в ньому — це навмисно, і лише тут ця зупинка відрізняється від усіх інших. Кожна інша зупинка вказує на файл і поле, які слід відредагувати, щоб її усунути; тут такого файлу немає, тож позиція відправила б вас до ключа, який не винен. Натомість повідомляється тип, щодо якого розходяться два подання, бо саме це робить розбіжність відтворюваною для того, хто її досліджуватиме.

Повідомлення, що виводиться:

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>") (власні представлення каталогу в компіляторі розходяться (внутрішня помилка: ця збірка розв’язала тип компонента, для якого каталог, що вона читає, потім не містив запису. Це дефект компілятора, а не написаного документа, тож в Aggregate, Release чи каталозі нічого виправляти не потрібно. Будь ласка, повідомте про це, вказавши команду, що створила цю збірку, і тип, щодо якого представлення розходяться))

Як виправити: у ваших файлах нічого — це повідомлення про неузгодженість усередині компілятора, а не про помилку в написаному вами, і про неї варто повідомити як про дефект, вказавши тип, названий у повідомленні. Тип компонента майже напевно правильний.

A reference names no entity the catalog holds (Посилання не вказує на жодну сутність, яка є в каталозі)

Перш ніж збірка щось відрендерить, обходиться весь набір сутностей, від яких залежить сутність Release, і кожну з них закріплюється, тож lockfile записує саме те, що читатиме збірка. Посилання, на яке каталог не може відповісти, зупиняє цей обхід: для нього нічого не можна закріпити, а продовження записало б lockfile без запису, потрібного збірці пізніше, і ніщо б про це не повідомило.

Відмова називає посилання та місце, де його зібрано, бо до однієї сутності доходять з багатьох місць, а виправлення потрібне саме там, де її названо. Посилання на бібліотеку повідомляється окремо, без шляху збирання: до бібліотеки доходять від сутностей, які виконують для неї $ref або $import, і вся помилка полягає в хибній назві.

Повідомлення, що виводиться, для сутності каталогу — кінцева частина перелічує місця, які на неї посилаються:

resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from <referring paths>) (resolve: жодна сутність у каталозі не відповідає цьому URI: сутність, на яку посилаються з указаних шляхів)

для бібліотеки:

resolve: no entity in the catalog matches this URI: library "<reference>" (resolve: жодна сутність у каталозі не відповідає цьому URI: бібліотека)

і для плагіна, прив’язаного до сокета провайдера, який названо ключем конфігурації робочого простору, що його містив, а не документом каталогу:

resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from .aggrega-config.yaml.plugins.providers) (resolve: жодна сутність у каталозі не відповідає цьому URI: сутність, на яку посилаються з .aggrega-config.yaml.plugins.providers)

Коли файл у каталогах каталогу оголошує ім’я, яке запитує посилання, під видом, якого не містить жоден каталог, — наприклад, із помилкою в написанні kind, — примітка під цим збоєм називає цей файл, вид, який він оголошує, і види, які містить каталог, та не включає пораду про те, звідки читаються локальні сутності, як у збірці, що заповнює свій lock-файл, так і в збірці, що його читає, а також на кожній іншій поверхні, яка повідомляє про цей збій; див. Відхилений файл каталогу і збій, який він пояснює.

Як виправити: прочитайте посилання точно так, як його цитує повідомлення. Назва, якої не існує, версія, яку ніколи не публікували, і проста назва, на реєстр якої робочий простір не налаштовано, потрапляють сюди однаково, тож перевірте ці три випадки в такому порядку: виправте написання; переконайтеся, що версія існує; переконайтеся, що реєстр, який її містить, налаштовано й доступний. Якщо сутність ви створюєте локально, переконайтеся, що файл лежить у каталозі, який обходить збірка.

Коли aggrega pull або aggrega build --auto-pull зупиняється на посиланні на бібліотеку, а кеш артефактів містить SchemaLibrary, яку не закріплює жоден запис lockfile і не надає жодна директорія каталогу, за повідомленням іде рядок remediation:, що називає кожну таку бібліотеку. Кешована бібліотека вважається вмістом каталогу лише тоді, коли запис lockfile засвідчує її дайджест, а pull фіксує цей запис за реєстром, який надає бібліотеку. В автономному режимі pull не може ні завантажити бібліотеку, ні зафіксувати для неї запис, тож рядок радить запустити aggrega pull --release <release> там, де доступний реєстр, або створити бібліотеку в директорії каталогу. З підключенням жодна директорія каталогу чи реєстр, які читає pull, не надають бібліотеку, тож фіксувати нічого, і рядок указує на створення бібліотеки в директорії каталогу.

A library reference is not written in the identity form (Посилання на бібліотеку записано не у формі ідентичності)

Міжбібліотечний $ref: або $import: називає бібліотеку за ідентичністю, а потім запис у ній: просту назву бібліотеки, за потреби : і нижню межу версії, потім # і шлях запису на поверхні, яку читає поле. Хоста реєстру в цій формі немає. Через який реєстр розв’язується назва — це конфігурація робочого простору, а яку версію використовує збірка — відповідь lockfile, тож посилання з будь-чим із цього зафіксувало б у документі те, що має вирішувати збірка.

Тут відхиляються: значення з хостом реєстру; якір усередині документа, записаний там, де очікувалося міжбібліотечне посилання; порожня назва бібліотеки; і @, записаний як роздільник версії, — про нього повідомляється з виправленим написанням, а не як про загальну помилку форми, бо це найчастіша помилка в цій формі.

Повідомлення, що виводиться:

resolve: invalid library reference URI: "<the value as written>" (resolve: недійсний URI посилання на бібліотеку)

а там, де роздільником використано @, з цитуванням того, яким має бути значення:

resolve: invalid library reference URI: version separator is ’:’, not ’@’ — use "<the corrected value>" (resolve: недійсний URI посилання на бібліотеку: роздільник версії — ’:’, а не ’@’ — використайте виправлене значення)

Як виправити: перепишіть значення як <Library>#<entry-path>, додаючи :<version> після назви бібліотеки лише тоді, коли потрібна нижня межа версії, яку можна обрати. Приберіть будь-який хост реєстру. Якщо посилання мало вказувати всередину того самого документа, то якір усередині документа — це не те саме, що посилання на бібліотеку, а поле, у якому ви його записали, очікує форму бібліотеки.

Two consumers of one library require incompatible versions (Два споживачі однієї бібліотеки вимагають несумісних версій)

На одну бібліотеку можуть посилатися кілька сутностей, кожна з нижньою межею версії або без неї, і збірка обирає найвищу межу, яку назвала будь-яка з них. Саме тому споживач, який просить менше, усе одно отримує версію, що його задовольняє, і саме тому додавання споживача з вищою межею піднімає всіх, а не розділяє збірку на дві копії.

Це правило діє, лише доки межі збігаються в старшому номері версії. Два споживачі з різними мажорними версіями просять дві бібліотеки, які просто мають однакову назву, і жоден вибір не задовольнить обох — тож замість того, щоб обрати одну й дати іншому споживачеві читати форму, під яку його не писали, збірка зупиняється й називає розбіжність. Споживач без межі тут ні в чому не бере участі: вибір визначають споживачі, які закріпили версію.

Повідомлення, що виводиться. Споживачів порівнюють у відсортованому порядку: перший, хто назвав межу, задає мажорну версію, а повідомлення перелічує кожного порівняного споживача до першого, чия межа називає іншу мажорну версію, включно, разом із версією, якої він вимагав, — тож ті самі документи завжди називають тих самих споживачів:

resolve: minimal version selection conflict — incompatible library version requirements: library "<library>" has consumers requiring incompatible majors: <consumer> wants <version>; <consumer> wants <version> (resolve: конфлікт мінімального вибору версії — несумісні вимоги до версії бібліотеки: бібліотека має споживачів, що вимагають несумісних мажорних версій)

Як виправити: підніміть межу нижчого споживача до тієї самої мажорної версії — це звичайна відповідь, коли новішу форму хочуть усі. Якщо обидві мажорні версії справді потрібні одночасно, це дві бібліотеки: опублікуйте старішу форму під власною назвою й спрямуйте туди споживача, якому вона потрібна, щоб кожне посилання називало те, під що його писали.

The chain of module imports is deeper than the pin walk descends (Ланцюжок імпортів модулів глибший, ніж спускається обхід закріплення)

Закріплення обходить кожен модуль, який імпортує сутність Aggregate, потім кожен модуль, який імпортують ті, тож до lockfile потрапляє весь набір, а не лише перший рівень. Уже записаний модуль удруге не обходиться, і саме це завершує звичайний цикл: сутність Aggregate, що імпортує модуль, який імпортує її назад, завершується без скарг, записавши кожен один раз.

Межа глибини в десять рівнів страхує від ланцюжка, якого не бачить виявлення повторів: такого, що на кожному рівні має нову ідентичність, як-от модуль, повторно опублікований під новою версією на кожному кроці. Це та сама межа, яку застосовує побудовник графа, тож композиція, яка закріплюється, також і збирається.

Повідомлення, що виводиться:

resolve: sub-aggregate inclusion depth exceeded: "<module>" at depth <depth> (resolve: перевищено глибину включення вкладених агрегатів: модуль на вказаній глибині)

Як виправити: скоротіть ланцюжок. Такий глибокий ланцюжок зазвичай віддзеркалює устрій організації, а не розгортання, тож шукайте рівні, які не додають власних компонентів, і згорніть їх у батьківські. Якщо кожен рівень існує лише для того, щоб повторно опублікувати рівень під ним під новою версією, ланцюжок утворюють самі версії: імпортуйте потрібний модуль безпосередньо, у потрібній версії.

Це межа обходу закріплення. Побудовник графа застосовує власну, про яку повідомляється нижче як «Sub-aggregate nesting depth exceeded» (Перевищено глибину вкладення вкладених агрегатів), і це два окремі повідомлення про ту саму межу, досягнуту у двох точках: перше — під час заповнення lockfile, друге — під час побудови графа.

The catalog view a build was given cannot load the bodies pinning needs (Подання каталогу, надане збірці, не може завантажити тіла, потрібні для закріплення)

Двом із осей, які обходить закріплення, потрібна від каталогу не лише відповідь щодо версії: їм потрібні самі документи. Модулі, які імпортує сутність Aggregate, треба прочитати, щоб знайти, що імпортують вони. Сутності Recipes, FeatureRecipes і Plugins, які прив’язує збірка, треба прочитати, щоб знайти артефакти й бібліотеки, які називають вони. Подання каталогу, яке може розв’язати версію, але не може повернути ці тіла, залишає обидві осі без того, що читати.

Обидва випадки відхиляються одразу, а не пропускаються, і причина в тому, що дав би пропуск: lockfile без цілого класу записів, записаний без скарг, який пізніша збірка точно відтворює й виявляє неповним. Жодне з повідомлень не містить власних значень, бо жодне не стосується написаного вами документа — кожне вказує, яку вісь не можна обчислити:

resolve: catalog lookup cannot load resolved sub-aggregate bodies (resolve: пошук у каталозі не може завантажити тіла розв’язаних вкладених агрегатів) resolve: catalog lookup cannot load resolved recipe and plugin bodies (resolve: пошук у каталозі не може завантажити тіла розв’язаних рецептів і плагінів)

Як виправити: жодне з них не спричиняють ваші файли, і немає зміни в авторських документах, яка б його усунула — помилка в тому, як збірку налаштовано, а не в тому, що їй доручили зібрати. Повідомте про неї, вказавши команду, яку ви запустили, і конфігурацію робочого простору, з якою вона працювала.

An annotation-transform plugin names a component it was not given, or injects a value no annotation takes (Плагін перетворення анотацій називає компонент, якого йому не передали, або впроваджує значення, якого не приймає жодна анотація)

Оператор може під’єднати плагін керування в ролі, що додає анотації, і таке під’єднання є декларацією: оператор сам попросив про перетворення, тож те, що додає плагін, є явним, а не впровадженим непомітно для будь-кого. Роль відповідно обмежено. Плагін отримує координати компонентів, які оголошують ваші документи, і може додавати до них анотації, кожна з яких несе значення, яке ви могли б самі записати в цій анотації: рядок або об’єкт із підключів. Форма, яку він повертає, не допускає жодного іншого поля, тож під час застосування його виводу лишається перевірити, чи кожне впровадження назвало координату, яку йому передали, і чи кожне значення є таким, яке приймає анотація.

Впровадження, що називає пару межі й компонента поза цим набором, зупиняє збірку. Плагін, який дістається до компонента, що його ваші документи ніколи не відкривали, конфігурував би інфраструктуру, якої ніхто не оголошував, а анотації, які він додає, розгортаються в під’єднання Feature точно так само, як авторські, тож наслідком були б ресурси, що з’являються з компонента, якого оператор йому не надавав.

Впровадження, значенням якого є null, список, число, логічне значення або об’єкт без підключів, теж зупиняє збирання. Null і порожній об’єкт читаються як значення, яке записують, щоб вилучити компонент з анотації, яку він успадкував би, а ця роль додає анотації, а не вилучає їх; інші форми не є значеннями, які приймає анотація. Увесь вивід перевіряється до застосування будь-якої його частини, тож відхилений вивід нічого не змінює.

Кожне прийняте впровадження також має супровідну анотацію aggrega.ai/injected-by, що називає плагін, який його зробив. Цю анотацію записує хост; плагін не може надати її сам, тож те, що вона каже про походження впровадженої анотації, плагін формувати не може.

Повідомлення, яке видається для координати, якої плагіну не передали, і для значення, якого не приймає жодна анотація:

annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys: injection targets boundary "<boundary>" component "<component>" (annotation "<key>") (вивід плагіна перетворення анотацій відхилено: впровадження спрямоване на координату компонента, якої хост не передавав, або несе значення, яке не є рядком чи об’єктом із підключів: впровадження спрямоване на вказаний компонент вказаної межі (вказана анотація)) annotation-transform 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 (вивід плагіна перетворення анотацій відхилено: впровадження спрямоване на координату компонента, якої хост не передавав, або несе значення, яке не є рядком чи об’єктом із підключів: впровадження для вказаного компонента вказаної межі (вказана анотація) несе список; впроваджене значення анотації — це рядок або об’єкт із підключів)

Як виправити: помилка в плагіні, а не у ваших документах — виправте його, щоб він впроваджував лише на передані йому координати, кожна з яких надходить у його вхідних даних, і лише рядок або об’єкт із підключів як значення. Якщо компонент із повідомлення — той, який, за вашими очікуваннями, плагін мав бачити, перевірте, що сутність Release оголошує його всередині межі: передаються лише оголошені координати компонентів. Вилучення під’єднання з plugins.governance — негайний спосіб розблокувати збірку, поки плагін виправляють.

A plugin reference is not a Plugin entity (Посилання на плагін не є сутністю Plugin)

На плагін посилаються через його сутність Plugin, завжди з областю за власним типом сокета плагіна: <pluginType>/<name>, за потреби з версією, як у parser/yaml або parser/yaml:1.0.0. Область обов’язкова, а не одна з кількох форм — посилання без області name:version відхиляється, бо два сокети можуть містити плагін з однаковою назвою, і саме область робить сутність розв’язуваною. До бінарного файлу, на який вказує сутність, звертаються через сутність і ніколи не називають його безпосередньо, тож саме сутність несе заяву про можливості, обмеження середовища виконання й записаний набір команд, з якими під час завантаження звіряється бінарний файл. Тому посилання, що не називає жодної сутності Plugin, не має з чим звірити бінарний файл, і збірка зупиняється, а не завантажує байти за неперевіреним посиланням.

Тут повідомляється про дві форми, і перевіряються вони в різні моменти. Посилання, чия форма не може бути сутністю — шлях у файловій системі або посилання на артефакт, як-от URL oci://, простий .wasm чи дайджест @sha256:, — відхиляється одразу на тих поверхнях, що приймають лише посилання на сутності. Посилання, що не називає жодної сутності, яку щось містить, відхиляється після пошуку, і зміст повідомлення залежить від того, як його записано: про URI сутності Plugin — <pluginType>/<name>, за потреби з версією, — повідомляється як про сутність, якої не містить жоден каталог, не несе бінарний файл і не отримав жоден pull, а будь-якому іншому посиланню пропонується набути цієї форми. Обидві форми повідомляють про ту саму умову, тож реакція збірки на кожну однакова.

Pull відхиляє другу форму ще до того, як із нею зіткнеться збірка. Кожен Plugin, який називає pipeline сутності Recipe чи FeatureRecipe, розв’язується разом з рештою залежностей сутності Release — з каталогу, з копії всередині бінарного файлу компілятора, з кешу вмісту або з реєстру, — і той, якого не містить жодне з них, зупиняє aggrega pull до запису lockfile з цією умовою й тим самим повідомленням, що називає Recipe чи FeatureRecipe, чий pipeline його називає.

Не кожна поверхня відхиляє форму, що не є сутністю. Поверхня плагінів pipeline приймає лише посилання на сутності; поверхні, до яких оператор під’єднує плагін безпосередньо, приймають будь-яку форму й передають посилання, що не є сутністю, на розв’язання як артефакт. Тож те саме посилання може бути прийняте в одній точці під’єднання й відхилене в іншій, і ця різниця — властивість поверхні, а не посилання.

Повідомлення, що виводяться. Шлях у файловій системі:

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) (посилання на плагін не є сутністю Plugin: “<reference>” — шлях у файловій системі, але плагін pipeline має бути URI сутності Plugin з областю за типом плагіна (<pluginType>/<name>, за потреби з версією, як у parser/yaml або parser/yaml:1.0.0))

посилання на артефакт:

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) (посилання на плагін не є сутністю Plugin: “<reference>” — посилання на артефакт (схема oci://, простий .wasm або дайджест @sha256:), але плагін pipeline має бути URI сутності Plugin з областю за типом плагіна (<pluginType>/<name>, за потреби з версією, як у parser/yaml або parser/yaml:1.0.0))

URI сутності Plugin, якої ніщо не містить:

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 (посилання на плагін не є сутністю Plugin: “<reference>” — URI сутності Plugin, але жоден каталог не містить сутності, яку він називає, бінарний файл її не несе, і жоден pull не отримав її в кеш вмісту; розмістіть сутність Plugin у каталозі або опублікуйте її в реєстрі й виконайте aggrega pull)

і будь-яке інше посилання, що не називає жодної сутності, — без області за типом плагіна, з більш ніж одним / перед версією або з хостом реєстру:

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 (посилання на плагін не є сутністю Plugin: “<reference>” має бути URI сутності Plugin з областю за типом плагіна (<pluginType>/<name>, за потреби з версією, як у parser/yaml або parser/yaml:1.0.0); просте посилання на .wasm або посилання на артефакт не називає жодної сутності Plugin)

Як виправити: запишіть посилання як ідентичність сутності Plugin з областю за типом сокета, за потреби з версією — <pluginType>/<name> або <pluginType>/<name>:<version>. Якщо ви вказували безпосередньо на файл чи артефакт, опублікуйте або створіть для нього сутність Plugin і посилайтеся на неї — саме в сутності містяться заяви, які перевіряє завантаження, тож рівноцінної форми, що її оминає, немає. Якщо повідомлення каже, що посилання є URI сутності Plugin, його форма правильна, а бракує самої сутності: розмістіть сутність Plugin у каталозі, який перелічує робочий простір, поруч із її зібраним .wasm, або опублікуйте плагін у реєстрі, який читає робочий простір, і виконайте aggrega pull, що отримає його в кеш вмісту, — і перевірте, що вказана версія існує.

A cached signature bundle does not match the digest recorded for it (Кешований пакет підпису не збігається із записаним для нього дайджестом)

Артефакт, підпис якого було перевірено під час отримання, переносить цей факт у свій запис lockfile — або, для плагіна, підключеного в ролі вердикту, у свій запис у plugins-trust.yaml — як записаний дайджест матеріалу підпису, кешованого поруч з артефактом. Перш ніж щось рендериться, збірка повторно зчитує цей кешований матеріал для кожного прочитаного запису, який його записує, — сутності каталогу будь-якого виду, бібліотеки, плагіна — і повторно обчислює його хеш, і цей хеш має бути записаним. Для плагіна, який закріплює lockfile, і для плагіна, підключеного в ролі вердикту, матеріал перевіряється ще раз під час завантаження його байтів, і саме так перевірка охоплює команди, що завантажують плагін поза збіркою, — серед них aggrega lint --release і aggrega validate --release. Пакет, який відсутній, не читається або має інший хеш, означає, що перевірений матеріал не відповідає тому, що зараз на диску, і запуск зупиняється, а не використовує артефакт, свідчення підпису якого змінилися за записом.

Повторна перевірка — це лише порівняння хешів. Вона не перевіряє жодного підпису повторно, не звертається до мережі й не використовує матеріалу довіри, тож працює у збірці взагалі без доступу до мережі — саме це дозволяє артефакту, перевіреному один раз, залишатися перевіреним у подальших офлайн-збірках.

Наступний pull це виправляє. Pull піддає тій самій перевірці кожен запис, який надав кеш вмісту, і там, де перевірка відхиляє запис, знову запитує реєстр артефакту про підпис — незалежно від вимоги щодо підписування, через ту саму перевірку, яку проходить отримуваний ним артефакт, — записує в запис те, що ця перевірка підтверджує, і кешує пакет, який він називає, перезаписуючи кешовану копію, що більше не збігається зі своїм дайджестом. Плагін, підключений у ролі вердикту, перевіряється знову під час кожного pull незалежно від того, що записано в його записі, і його пакет кешується так само. Тому повідомлення для запису, який надав кеш вмісту, називає цей pull. Запис, прочитаний з каталогу каталогу, з копії всередині бінарного файлу компілятора або з місця поруч із сутністю Release, ніколи не запитується в реєстрі, тож pull залишає записаний у ньому підпис як є, і його повідомлення не називає жодного pull.

Повідомлення, що виводяться, називають артефакт, кешований файл і — для запису, який надав кеш вмісту, — pull, що це виправляє, файл, у який він записує підпис, і сутність Release, яку він отримує. Від перевірки збірки, якщо пакет не читається або відсутній:

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 (артефакт <reference>: кешований пакет підпису <path> неможливо прочитати: кешований пакет підпису не відповідає своєму записаному дайджесту. виправлення: запустіть aggrega pull —release <release>, щоб знову перевірити підпис артефакту в його реєстрі, записати його у <file> і кешувати пакет, який він називає)

і якщо дайджест розійшовся:

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 (артефакт <reference>: кешований пакет підпису <path> має дайджест <actual>, записаний дайджест — <recorded>: кешований пакет підпису не відповідає своєму записаному дайджесту. виправлення: запустіть aggrega pull —release <release>, щоб знову перевірити підпис артефакту в його реєстрі, записати його у <file> і кешувати пакет, який він називає)

і там, де байти плагіна завантажуються з кешу вмісту, також із зазначенням, звідки вони взялися:

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 (плагін <reference>, розв’язаний із <source>: кешований пакет підпису <path> неможливо прочитати: кешований пакет підпису не відповідає своєму записаному дайджесту. виправлення: запустіть aggrega pull —release <release>, щоб знову перевірити підпис артефакту в його реєстрі, записати його у <file> і кешувати пакет, який він називає)

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 (плагін <reference>, розв’язаний із <source>: кешований пакет підпису <path> має дайджест <actual>, записаний дайджест — <recorded>: кешований пакет підпису не відповідає своєму записаному дайджесту. виправлення: запустіть aggrega pull —release <release>, щоб знову перевірити підпис артефакту в його реєстрі, записати його у <file> і кешувати пакет, який він називає)

<file> — це lockfile сутності Release або plugins-trust.yaml у каталозі сутності Release. Для запису, про який не запитує жоден pull, повідомлення закінчується перед remediation:.

Pull, якому немає в якого реєстру запитати, натомість зупиняється. Сутність каталогу або бібліотека називаються без реєстру й прив’язуються до нього через default_registry робочого простору. Якщо робочий простір його не називає — називав, коли підпис було записано, а тепер ні, — жоден реєстр не налаштовано, щоб знову запитати про запис, тож pull зупиняється з цією умовою, а не записує lockfile, який наступна збірка відхилить, і залишає lockfile без змін. Його повідомлення містить після кроку, який виконував 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 (перевірка: <reference> записує підпис, який збірка не приймає, і не налаштовано жодного реєстру, щоб знову про нього запитати: кешований пакет підпису <path> неможливо прочитати: кешований пакет підпису не відповідає своєму записаному дайджесту)

Як виправити: ніщо у ваших файлах сутностей цього не спричиняє — кеш належить збірці, а не вам. Виконайте aggrega pull --release <release>, команду, яку називає повідомлення: вона знову перевіряє підпис артефакту й записує підпис разом з його пакетом, що виправляє пакет, вилучений або змінений після pull, який його кешував. В офлайн-режимі цей pull зупиняється — з офлайн-відмовою, бо виправлення означає звернення до реєстру, або, для плагіна, підключеного в ролі вердикту, ще до того, називаючи .wasm плагіна як такий, що його не вдалося розв’язати, бо pull розв’язує цей .wasm із реєстру плагіна; дозвіл мережі для цього одного запуску це виправляє. Якщо pull зупиняється з повідомленням, що не налаштовано жодного реєстру, щоб запитати про запис, задайте default_registry як реєстр, з якого було отримано артефакт, і виконайте pull знову. Якщо робочий простір пропускає перевірку підпису для артефакту, pull натомість не записує підпису в запис, і збірка допускає це за того самого налаштування. Якщо підпис, який надає реєстр, не проходить перевірку, pull зупиняється з власною відмовою цієї перевірки: записаний підпис і матеріал, який надає видавець, справді розходяться, і це питання до того, хто публікує артефакт. Для запису, повідомлення якого не називає жодного pull, — прочитаного з каталогу, з копії всередині бінарного файлу компілятора або з місця поруч із сутністю Release, — вилучіть signature з його запису: до такого запису ніколи не застосовується вимога підпису, тож після цього збірка продовжується.

A recorded signature was made for a different artifact (Записаний підпис створено для іншого артефакту)

Підпис указує, для якого артефакту його створено. Коли pull перевіряє підпис артефакту, він записує цей факт у запис артефакту в lockfile — або, для плагіна, підключеного в ролі вердикту, у його запис у plugins-trust.yaml — і кешує перевірений підпис. Перш ніж щось буде відрендерено, збірка зчитує з кешованого підпису кожного запису, який надав кеш вмісту, для якого артефакту його створено, і це має бути той артефакт, який сама збірка зчитала для цього запису: той, чий маніфест зберігається поруч із його байтами в кеші вмісту, а не будь-що, що записано в записі. Підпис, створений для іншого артефакту, зупиняє збірку. Саме так виглядає signature, скопійований з одного запису в інший: кешований підпис, який він називає, цілий — він досі відповідає записаному для нього дайджесту — і його створено для артефакту іншого запису.

Це не залежить від вимоги підпису. Записаний підпис перевіряється на відповідність тому, що він стверджує, незалежно від того, чи підпис вимагається, так само як і перевірка того, що кешований підпис відповідає своєму записаному дайджесту.

Плагін перевіряється так само, хоч би де його завантажували. Для плагіна, який закріплює lockfile, і плагіна, підключеного в ролі вердикту, записаний підпис звіряється з артефактом, як який було зчитано його байти, коли ці байти завантажуються з кешу вмісту; це охоплює команди, що завантажують плагін поза збіркою, — зокрема aggrega lint --release і aggrega validate --release, а також ті самі операції, викликані через aggrega serve і aggrega mcp.

Що зчитує перевірка і чого вона не може розрізнити. Вона зчитує кешований підпис і маніфест поруч з артефактом і порівнює хеші: вона не перевіряє жодного підпису, не звертається до мережі й не використовує матеріалів довіри, тож працює і в збірці зовсім без доступу до мережі. Вона визначає, для якого артефакту створено підпис, в обох формах, які приймає pull, — підпис, створений над самим артефактом (саме такі створюють власні підписувачі інструментарію), і підписане твердження, що називає артефакт, — тож підпис, скопійований з одного запису в інший, відхиляється в будь-якій формі. Це те саме зчитування, яке pull застосовує до кожного підпису, що його приймає: pull відхиляє підпис, який проходить перевірку, але для якого зчитування не знаходить, що його створено для цього артефакту, або взагалі не може визначити з нього артефакт, тож жоден підпис, записаний pull, не є таким, якого перевірка не може прочитати. Запис, зчитаний з каталогу, з копії всередині двійкового файлу компілятора або з місця поруч із сутністю Release, не має маніфесту, тож його записаний підпис звіряється лише з його записаним дайджестом; так само й підпис, розміщений у кеші вручну у формі, що не є жодною з цих двох. І оскільки жоден підпис не перевіряється, підпис, вписаний у кеш вручну й виданий для власного артефакту запису, не відрізняється від підпису, перевіреного pull.

Наступний pull це виправляє. Pull піддає кожен запис, який надав кеш вмісту, тій самій перевірці, і там, де перевірка відхиляє запис, він знову запитує реєстр артефакту про підпис — хоч би що казала вимога підпису — і записує те, що це підтверджує, у запис замість скопійованого підпису. Плагін, підключений у ролі вердикту, перевіряється знову під час кожного pull, хоч би що записано в його записі. Лише запис, який надав кеш вмісту, перевіряється на те, для якого артефакту створено його підпис, тож кожна відмова через цю умову під час збірки або завантаження плагіна називає цей pull.

Повідомлення, що виводяться, називають запис, файл, який записує підпис, кешований підпис, маніфест, який збірка зчитала для запису, і pull, що це виправляє. Від перевірки збірки:

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 (артефакт «<reference>»: підписування: записаний підпис створено для іншого артефакту (його записує <file>, кешований пакет підпису <path>, прочитаний артефакт має маніфест <manifest-digest>). усунення: виконайте aggrega pull —release <release>, щоб знову перевірити підпис артефакту в його реєстрі, записати його в <file> і кешувати пакет, який він називає)

і, коли завантажуються байти плагіна, також із зазначенням, звідки їх отримано:

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 (плагін «<reference>», розв’язаний із <source>: підписування: записаний підпис створено для іншого артефакту (його записує <file>, кешований пакет підпису <path>, прочитаний артефакт має маніфест <manifest-digest>). усунення: виконайте aggrega pull —release <release>, щоб знову перевірити підпис артефакту в його реєстрі, записати його в <file> і кешувати пакет, який він називає)

<file> — це lockfile сутності Release або plugins-trust.yaml у каталозі сутності Release.

Pull, якому нема в якого реєстру запитати, натомість зупиняється, як і для кешованого пакета підпису, що більше не відповідає своєму дайджесту: якщо сутність каталогу або бібліотека має скопійований підпис, а робочий простір більше не називає default_registry, до якого її прив’язати, pull зупиняється з цією умовою й залишає lockfile без змін. Його повідомлення містить після кроку, який виконував 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>) (перевірка: «<reference>» записує підпис, який збірка не приймає, і не налаштовано жодного реєстру, щоб знову запитати про нього: підписування: записаний підпис створено для іншого артефакту (кешований пакет підпису <path>, прочитаний артефакт має маніфест <manifest-digest>))

Як виправити: ніщо у ваших файлах сутностей цього не спричиняє — підпис, який записує запис, належить іншому артефакту. Виконайте aggrega pull --release <release>, команду, яку називає повідомлення: вона перевіряє власний підпис запису в його реєстрі й записує його замість скопійованого — однаково для запису lockfile і для плагіна, приєднаного в ролі вердикту. Також можна відновити власний записаний підпис запису із системи контролю версій, якщо файл закомічено. В офлайн-режимі pull зупиняється — з офлайн-відмовою, бо виправлення означає звернення до реєстру, або, для плагіна, приєднаного в ролі вердикту, ще до того, називаючи .wasm плагіна як такий, що його не вдалося розв’язати, бо pull розв’язує цей .wasm із реєстру плагіна; дозвіл мережі для цього одного запуску це виправляє. Якщо pull зупиняється з повідомленням, що не налаштовано жодного реєстру, щоб запитати про запис, задайте default_registry як реєстр, з якого було отримано артефакт, і виконайте pull знову. Якщо робочий простір пропускає перевірку підпису для артефакту, pull натомість не записує підпису в запис, і збірка допускає це за того самого налаштування.

No verified signature is recorded for an artifact that requires one (Для артефакту, який потребує підпису, не записано перевіреного підпису)

Pull, який отримує артефакт із реєстру, перевіряє його підпис за політикою довіри цього реєстру й записує перевірений факт у запис артефакту в lockfile. Збірка не звертається до жодного реєстру, тому вона читає записаний факт, а не перевіряє знову, — і перш ніж щось рендериться, вона перевіряє кожен прочитаний запис на відповідність вимозі, яку застосував pull, коли отримував артефакт. Запис, наданий кешем вмісту, для артефакту, для якого потрібен підпис, що не містить перевіреного підпису, зупиняє збірку: ніщо з того, що є у збірки, не свідчить, що артефакт, з якого вона збирається рендерити, колись було перевірено.

Вимога та сама, що й у pull, налаштування за налаштуванням. Підпис потрібен там, де загальна для робочого простору політика підписування охоплює тип артефакту, або там, де власний запис реєстру в .aggrega-config.yaml — або, для hub.aggrega.ai без власного запису, вбудована політика офіційного хабу — його вимагає; артефакт, тип якого не вдалося визначити, вважається таким, що потребує підпису, за активної політики. Те, що дозволяє pull прийняти артефакт без підпису, дозволяє й збірці прийняти його запис: skip_signature_verification на верхньому рівні, той самий перемикач у власному записі реєстру, крім типу, якого вимагає загальна політика робочого простору, і реєстр, позначений як advisory.

Походження запису визначається зі збірки, а не з lockfile. Перевіряється кожен запис, наданий кешем вмісту, хоч би що ще в ньому було записано, тож видалення дайджесту маніфесту запису разом із його підписом не звільняє його від перевірки. Запис, прочитаний із каталогу, з копії всередині бінарного файлу компілятора або з місця поруч із сутністю Release, ніколи не перевіряється, бо підпису реєстру не існує для байтів, що надійшли не з реєстру. Записи всіх розділів перевіряються однаково — сутності каталогу, бібліотеки й артефакти плагінів, — і кожен відхилений перевіркою запис називається в тому самому запуску.

Плагін, приєднаний у ролі вердикту, підлягає тій самій перевірці — через plugins-trust.yaml. Приєднання plugins.governance у ролі ir-verdict або render-verdict і кожне приєднання plugins.linter не формують жодного відрендереного байта, тому не мають запису в lockfile; натомість його перевірений підпис містить запис поруч із lockfile. Кожен такий плагін, який збірка читає з кешу вмісту, перевіряється на ту саму вимогу за тими самими налаштуваннями: запис у цьому файлі без підпису зупиняє збірку, як і повна відсутність запису для плагіна — видалення файлу записів не звільняє від перевірки. Плагін, наданий із каталогу або з копії всередині бінарного файлу компілятора, не перевіряється. Вимога діє для такого плагіна, де б його не завантажували для сутності Release, а не лише у збірці: aggrega lint --release і aggrega validate --release, а також ті самі операції через aggrega serve і aggrega mcp, завершуються з помилкою за цієї умови, коли його завантажують.

Повідомлення, що виводяться, називають запис, файл, який не містить для нього підпису, налаштування, що вимагають його підпису, і команду, яка записує його в цей файл. Для запису lockfile — із назвою 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>

а для плагіна, приєднаного в ролі вердикту, — із назвою його файлу записів:

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>

Обидва файли названо за їхнім шляхом поруч із сутністю Release, переданою команді: <lockfile-path> — це lockfile сутності Release, а <record-path> — це plugins-trust.yaml у каталозі сутності Release.

Налаштування називаються словами самого файлу конфігурації: `signing.required` at the top level of the workspace configuration, `signing.required` on the `registries` entry for "<host>" або the official hub's built-in signature requirement for "hub.aggrega.ai", об’єднані, якщо застосовується більше одного.

Як виправити: виконайте pull, який називає повідомлення. Для запису, наданого кешем вмісту, який не містить підпису там, де його вимагають, pull запитує в реєстру артефакту його підпис за дайджестом маніфесту, записаним у запис, точно так само, як для артефакту, який він отримує, і записує перевірений підпис у запис — тож наступна збірка його прочитає. Про плагін, приєднаний у ролі вердикту, запит робиться під час кожного pull у будь-якому разі, і pull записує те, що він перевірив, у запис плагіна в plugins-trust.yaml, створюючи запис, якщо його немає. Реєстр, який не прикріплює підпису, або підпис, якого не приймає конфігурація довіри, натомість зупиняє цей pull із зазначенням артефакту, і це питання до того, хто його публікує. В офлайн-режимі pull не може зробити запит: щодо запису lockfile він відмовляє, вказуючи, як дозволити мережу для одного запуску, а щодо плагіна, приєднаного в ролі вердикту, зупиняється ще до запиту, називаючи .wasm плагіна таким, що його не вдалося розв’язати, бо pull розв’язує цей .wasm з реєстру плагіна. Відновлення записаного підпису запису із системи контролю версій усуває проблему без мережі, якщо кеш досі містить матеріал підпису, який називає цей запис. Якщо артефакт не призначений для підписування, змінювати слід вимогу, і повідомлення називає, яке це налаштування, — але її послаблення означає, що артефакти цього реєстру більше не перевірятимуться й під час pull, тож краще звузити типи в загальній політиці робочого простору, ніж вимикати вимогу.

A recorded signature is not the one a pull would record (Записаний підпис не той, який записало б витягування)

aggrega pull --verify повідомляє, чи змінив би запуск aggrega pull зараз файли, які фіксує витягування, а підпис, який витягування перевірило для артефакту, є частиною того, що воно записує: signature у записі lockfile, а також у записі plugins-trust.yaml для плагіна, приєднаного в ролі вердикту. Ця умова — те, що перевірка повідомляє для кожного записаного підпису, який звичайне витягування записало б інакше: записало б там, де жодного не записано, замінило б або очистило б. Перевірка не записує жодного з файлів і називає кожен такий запис в обох файлах за один запуск.

Про два види записів lockfile повідомляється без запиту до реєстру, бо витягування переписує їх незалежно від відповіді реєстру, тож про них повідомляється і в офлайн-режимі: запис, який надав кеш вмісту і який не містить підпису там, де конфігурація довіри його вимагає, — витягування записує підпис артефакту або зупиняється, якщо не може його встановити, — і запис, чий записаний підпис зроблено для іншого артефакту, який витягування замінює власним підписом артефакту.

Про кожен інший запис, який витягування шукало б знову, робиться запит, бо лише відповідь реєстру показує, чи змінило б його витягування: запис, байти якого перевірка завантажила, бо кеш вмісту їх не містив, і запис, чий кешований пакет підпису видалено, неможливо прочитати або змінено. Перевірка запитує реєстр так, як це зробило б витягування, повідомляє про запис, якщо відповідь записує, замінює чи очищує його підпис, і кешує перевірений пакет так, як його кешує витягування. В офлайн-режимі про такий запис не запитують і не повідомляють: перевірка виводить рядок, що називає його й повідомляє, що його підпис не перевірено.

Щодо запису довіри плагінів кожне витягування перевіряє в реєстрі підпис кожного плагіна, підключеного в ролі вердикту, і так само робить перевірка: повідомляється про запис, чий підпис ця перевірка записала б, замінила б або очистила б, а також про плагін, для якого запис не містить елемента, якщо збірка відхиляє його через відсутність записаного підпису, бо витягування записує елемент із його підписом, а збірка відхиляє плагін доти. Будь-який інший плагін, якого запис ще не містить, є першою появою, і про нього не повідомляється. В офлайн-режимі перевірка не запитує жоден реєстр про ці плагіни: вона читає кожен із кешу вмісту, як його читає збірка, і перевіряє його ідентичність та функції хоста так, як це робить перевірка з підключенням. Без запиту вона повідомляє про плагін, який збірка відхиляє через відсутність записаного підпису — його елемент не містить жодного, або запис не містить для нього елемента, — і про той, який збірка відхиляє, бо підпис, записаний у його елементі, зроблено для іншого артефакту, адже витягування переписує такий елемент незалежно від відповіді реєстру; для кожного іншого елемента вона виводить рядок, що називає його й повідомляє, що його підпис не перевірено.

Позначки застарілості не порівнюються. Позначка, додана до артефакту після витягування, є станом реєстру й змінюється без жодних змін у робочому просторі, тож перевірка, що завершується помилкою через неї, провалювала б перевірку файлів, яких ніхто не торкався, — саме тому записана позначка лише попереджає збірку, а не зупиняє її.

Повідомлення, що виводяться, по одному на запис, називають запис, файл і те, що він містить, що натомість записало б витягування, і витягування, яке оновлює файл. Якщо відповідь реєстру або власна перевірка запису дає підпис, який записало б витягування:

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 (підписування: записаний підпис не той, який записало б витягування (файл записує один підпис, а витягування записало б інший). усунення: виконайте вказане витягування, щоб оновити файл)

для запису без підпису там, де він потрібен, — запису lockfile або, в офлайн-режимі, елемента запису довіри плагінів:

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

для запису, чий записаний підпис зроблено для іншого артефакту, — запису lockfile або, в офлайн-режимі, елемента запису довіри плагінів:

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: 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: 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

<signature> описує підпис його режимом, підписувачем і дайджестом його пакета — a keyed signature by keyed:sha256:<fingerprint> with bundle digest sha256:<digest>, з issued by <issuer> після підписувача для безключового підпису — або має значення no signature. <file> — це lockfile сутності Release, <lockfile-path>, або plugins-trust.yaml у каталозі сутності Release, <record-path>.

Як виправити: виконайте pull, який називає повідомлення. Він записує у названий файл ту signature, про яку каже повідомлення, і кешує її пакет, тож наступна перевірка проходить. Де повідомлення каже, що pull звернувся б до реєстру, pull записує те, що реєстр верифікує, — і натомість зупиняється, називаючи артефакт, де реєстр прикріплює підпис, якого конфігурація довіри не приймає, або не прикріплює жодного там, де він обов’язковий; це питання до того, хто публікує артефакт. В офлайн-режимі такий pull зупиняється: над записом lockfile — з офлайн-відмовою, бо він мусить звернутися до реєстру, а над плагіном, приєднаним у ролі вердикту, — ще до того, називаючи .wasm плагіна таким, що його не вдалося розв’язати, бо pull розв’язує цей .wasm з реєстру плагіна. Дозвіл на мережу для цього одного запуску оновлює файл. Де повідомлення каже, що pull не записав би жодного підпису, реєстр більше не прикріплює підпис і ніщо його не вимагає: pull очищає підпис запису, і збірка приймає це за тих самих налаштувань — якщо ви не очікували, що реєстр перестане підписувати артефакт, це теж питання до його видавця.

Файлу .wasm плагіна немає на цій машині

Файл .wasm плагіна читається з одного з чотирьох місць у такому порядку: плагіни, вбудовані в бінарний файл компілятора; файл поруч із сутністю Plugin плагіна в каталозі; явний шлях у файловій системі, який указує посилання; і кеш вмісту робочого простору, який заповнює aggrega pull. Розв’язання плагіна лише читає те, що вже є на машині, і нічого не завантажує, тож ця умова повідомляє, що жодне з чотирьох місць не містить байтів, а не що завантаження не вдалося. Один плагін є винятком: основний імпортер, потрібний імпорту. Його модуль читається лише з бінарного файлу або кешу вмісту, ніколи не з місця поруч із сутністю каталогу, а якщо жодне з них його не містить, імпорт один раз завантажує його з типового реєстру робочого простору; тоді умова повідомляє також, що завантаження було неможливим: робочий простір офлайн, його реєстр недосяжний або не містить модуля, або робочий простір не вказує типового реєстру. Модуль, який було завантажено і який не пройшов перевірку, натомість відхиляється за власною умовою — невідповідністю дайджесту або відхиленням підпису, — і нічого не зберігається.

Назва файлу поруч із сутністю утворюється з типу та імені плагіна сутності, і наведене нижче відхилення pull цю назву повідомляє: для pipeline-step/patch це pipeline-step--patch.wasm у каталозі, де лежить документ сутності.

Сутність Plugin, створена в одному з ваших каталогів, відхиляється, коли pull її розв’язує. Pull ніколи не завантажує .wasm такої сутності: він шукає в чотирьох наведених вище місцях, саме там, де шукає збирання. Крок конвеєра, провайдер або плагін, приєднаний у ролі вердикту, взагалі не закріплюється, і збирання щоразу читає його сутність із каталогу. Плагін, приєднаний у ролі трансформації, закріплюється, бо його байти формують згенерований результат: pull записує його сутність і дайджест вмісту знайденого там .wasm, а збирання відхиляє .wasm, який більше не відповідає. Тож pull, який не знаходить артефакт у жодному з чотирьох місць, зупиняється на цьому, перш ніж записати lockfile або будь-який entity.lock, замість того щоб залишити збиранню збій пізніше, на кроці, що завантажує плагін. .wasm, який містить бінарний файл, або той, що вже є в кеші вмісту, задовольняє pull так само, як і збирання, тож сутність для плагіна, що постачається всередині компілятора, не потребує файлу поруч.

Повідомлення, що виводяться. Відхилення pull, яке вказує на каталог, де очікувався файл, і під ним — розв’язання, про яке він питав:

plugin artifact not found on this machine (Plugin entity "<reference>" is authored in a catalog directory, expected <file> in <directory>). Place the built .wasm beside the entity under that name, or publish the plugin and reference the published Plugin entity instead of the one in the catalog directory (артефакт плагіна не знайдено на цій машині (сутність Plugin <reference> створено в каталоговій директорії, очікувався <file> у <directory>). Розмістіть зібраний .wasm поруч із сутністю під цим іменем або опублікуйте плагін і посилайтеся на опубліковану сутність Plugin замість тієї, що в каталоговій директорії)

плагін, який завантажує збирання або імпорт і байти якого не містить жодне джерело, а також плагін, приєднаний у ролі вердикту, який aggrega pull --verify в офлайн-режимі читає з кешу вмісту так само, як збирання. Якщо сутність Plugin плагіна лежить у теці каталогу, повідомлення називає його версію і місце, куди слід покласти його модуль:

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 у вказаному каталозі: артефакт плагіна не знайдено на цій машині)

а в інших випадках — із переліком кожного місця, де шукали модуль:

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, і кеш вмісту, у який завантажує pull, його теж не містить: артефакт плагіна не знайдено на цій машині)

Lint, який шукає лише у двійковому файлі, називає тільки перше з цих місць.

і те саме для посилання, записаного як розташування в реєстрі:

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 (плагін <reference> не вдається розв’язати: URI плагіна OCI потребує попереднього виконання aggrega pull —release <release> (щоб його байти були в кеші) або явного локального шляху; розв’язання плагінів не завантажує з реєстру: артефакт плагіна не знайдено на цій машині)

основний імпортер, який імпорт не зміг ні прочитати, ні завантажити, із назвою імпортера, його версією та причиною — тут робочий простір офлайн, — а далі те, що розміщує його модуль на машині:

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 (базового імпортера <importer> версії <version> немає на цій машині, а робочий простір працює офлайн, тому його реєстр <host> не запитується; виконайте імпорт один раз із доступною мережею — він завантажить імпортер із типового реєстру робочого простору, перевірить його і збереже в кеші вмісту для всіх наступних імпортів, — або розмістіть його модуль з іменем <file> поруч із сутністю Plugin для <importer> версії <version> у теці каталогу: артефакт плагіна не знайдено на цій машині)

Інші причини звучать як its registry <host> could not be reached (<cause>), its registry <host> holds no <location>:<version> і the workspace names no default registry to fetch it from; дві останні називають лише другий спосіб усунення, бо запуск із доступною мережею їх не змінить.

Як виправити: якщо сутність створюєте ви, зберіть плагін і розмістіть його .wasm поруч із сутністю під назвою, яку дає повідомлення, — або опублікуйте плагін за допомогою aggrega push і посилайтеся на опубліковану сутність замість копії в каталозі, оскільки ні pull, ні збирання не завантажують .wasm сутності з вашого каталогу. Якщо ви використовуєте плагін із реєстру, запустіть aggrega pull для релізу, що збереже його в кеші. Якщо ви очікували, що плагін містить сам компілятор, перевірте, чи містить його бінарний файл, який ви запускаєте: aggrega plugin list називає вбудовані плагіни. Якщо це основний імпортер, один раз запустіть імпорт там, де робочий простір може дістатися свого типового реєстру, — цей запуск завантажить, перевірить і збереже його в кеші, а всі наступні імпорти працюватимуть офлайн, — або, якщо цей реєстр його не містить, розмістіть його модуль поруч із сутністю Plugin цього імпортера цієї версії в теці каталогу під назвою, яку дає повідомлення; тоді ця сутність виконується замість основного імпортера.

A plugin recorded as a trusted gate is no longer attached (Плагін, записаний як довірений шлюз, більше не підключено)

Плагін, що повертає вердикт «прийняти чи відхилити» щодо збірки, записується, щойно його розв’язано, тож робочий простір зберігає запис про те, які шлюзи було переглянуто. Цю умову повідомляє записаний шлюз, який більше ніщо не підключає. Збірка зупиняється, а не проходить мовчки, тому що інакше її вивід неможливо було б відрізнити від виводу, схваленого шлюзом: збірка з мовчки відсутнім шлюзом і збірка, яку шлюз пропустив, створюють однакові файли, і ніхто, переглядаючи результат, не зміг би сказати, що саме перед ним.

Це інше питання, ніж плагін, чиї байти змінилися. Та умова відмовляється запускати плагін, який не є переглянутим, — це питання ідентичності. Ця умова відмовляється виконувати збірку, коли переглянутий шлюз повністю відсутній, — це питання наявності. Відповідно різняться й способи виправлення: відновити артефакт або відновити підключення.

Що це встановлює, а що ні. Звіряння конфігурації із записом встановлює, що кожен записаний шлюз досі підключено і що артефакт кожного з них є записаним. Воно нічого не встановлює щодо того, чи підключений шлюз узагалі повертає вердикт: підключення, чия вхідна функція називає оголошений експорт, що не повертає вердикту, запускається, нічого не повідомляє і пропускає збірку, і жодне порівняння із записом цього не помічає — запущений плагін точно той, що записаний, і він просто нічого не виконав. Два суміжні випадки все ж зупиняють збірку, і їх названо, щоб цю межу не сприйняли ширшою, ніж вона є: вхідна функція, що називає експорт, якого плагін не оголошує, відхиляється під час завантаження плагіна, а вивід із ключем, якого форма вердикту не оголошує, відхиляється, а не читається як порожній список вердиктів.

Повідомлення, що виводиться, називає запис, вилучені шлюзи та обидва способи виправлення:

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 (плагін, записаний як довірений для вердикту «прийняти чи відхилити», більше не приєднано до жодної ролі вердикту: <record-path> записує <plugin> як довірений, але жодне приєднання вердикту в конфігурації робочого простору його не називає; шлюз, який було переглянуто і якого тепер немає, залишає вихідні дані, які неможливо відрізнити від вихідних даних, схвалених цим шлюзом. Приєднайте плагін знову в plugins.governance з роллю ir-verdict або render-verdict чи в plugins.linter; або, якщо його мали прибрати, виконайте aggrega pull —upgrade —release <release> <plugin>, щоб вилучити його із запису — звичайний aggrega pull залишає запис як є, тож лише явне оновлення вилучає запис)

Якщо вилучено кілька шлюзів, їх названо разом в одній команді оновлення, а не по одній команді для кожного: цільове оновлення приймає кілька цілей і не чіпає жодного закріплення, якого не названо, тож назвати їх разом і коротше, і вужче, ніж повне оновлення, якого потребувала б альтернатива.

Як виправити: повідомлення пропонує два способи, бо лише ви знаєте, який із них доречний. Якщо шлюз вилучено помилково, підключіть плагін знову в plugins.governance у ролі вердикту або в plugins.linter. Якщо його мали вилучити, скажіть це явно цільовим оновленням, яке наводить повідомлення, — саме воно вилучає його запис. Не редагуйте й не видаляйте запис, щоб усунути цю умову: це закомічений запис того, що було переглянуто, і звичайний pull навмисно його не чіпає, бо мовчазне прийняття вилучення — саме те, чому ця відмова має запобігати.

A gate recorded as trusted resolves to a different identity (Шлюз, записаний як довірений, розв’язується в іншу ідентичність)

Плагін, що повертає вердикт «прийняти чи відхилити» щодо збірки, записується, щойно його розв’язано, разом із версією та дайджестом артефакту, у які він розв’язався. Цю умову повідомляє пізніше розв’язання, коли воно доходить до іншої версії чи інших байтів для шлюзу, який запис уже містить, а запуск не просив прийняти цю ідентичність.

Одна умова охоплює і змінену версію, і змінені байти, бо запис адресується ідентичністю плагіна і містить версію та дайджест як поля одного запису: порівняння розв’язання з ним — це одне порівняння з одним результатом. Повторна публікація, що змінила байти, і повторний push тієї самої версії для рецензента — та сама подія: ідентичність більше не та, що була переглянута.

Це інше питання, ніж записаний шлюз, який більше ніщо не підключає, — то питання наявності, а не ідентичності. Це також відрізняється від плагіна, чиї кешовані байти не збігаються із записаним дайджестом: та умова відмовляється запускати плагін, який не є переглянутим, і її виправлення — відновити або повторно записати артефакт, тоді як ця відмовляється приймати нову ідентичність без запиту, і її виправлення — назвати плагін в оновленні. Два способи виправлення, дві умови.

Запит нової ідентичності pull уже пропонує, і запросити її можна двома способами. Повне оновлення повторно розв’язує все, а цільове оновлення повторно розв’язує названі плагіни; будь-яке з них сприймається як запит нової ідентичності, і запис оновлюється. Будь-який інший pull утримує записану ідентичність і зупиняється — у цьому і сенс запису: запис, що приймав би будь-що розв’язане наступним, слідував би за розв’язанням, замість керувати ним. Перша поява не є розбіжністю: ідентичність, якої запис ще не містить, просто заповнюється.

Порівняння виконується також під час pull, який лише перевіряє, і такий pull не записує ні запис, ні lockfile. Перевірка, що пропустила б запис, перевіряючи lockfile поруч із ним, повідомила б про збіг, якого ніколи не шукала.

Повідомлення, що виводиться, називає плагін, обидві ідентичності та обидва способи виправлення:

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-identity>”: <record-path> записує для нього як довірену версію <recorded-version> із дайджестом <recorded-digest>, але це розв’язання повідомляє версію <resolved-version> із дайджестом <resolved-digest>; перегляньте, що змінилося, і прийміть це за допомогою aggrega pull —upgrade —release <release> <plugin> або відновіть записану ідентичність: ідентичність плагіна, записана як довірена, більше не збігається з тим, що повідомляє це розв’язання)

Як виправити: вирішіть, яку з двох ідентичностей ви маєте на увазі, бо це можете лише ви. Якщо зміна задумана — шлюз перепубліковано, і ви переглянули, що змінилося, — прийміть її цільовим оновленням, яке наводить повідомлення: воно повторно розв’язує цей плагін і переписує його запис. Якщо ви цього не очікували, переглянутою є записана ідентичність: відновіть версію або артефакт, які називає запис, і з’ясуйте, чому посилання тепер розв’язується інакше. Не редагуйте запис, щоб усунути цю умову: це закомічене твердження про те, що було переглянуто, і звичайний pull навмисно його не чіпає, бо мовчазне прийняття зміненого шлюзу — саме те, чому ця відмова має запобігати.

A Plugin entity’s claims disagree with the plugin’s own self-report (Твердження сутності Plugin не збігаються з власним звітом плагіна)

Сутність Plugin описує, що пропонує плагін, на який вона вказує: які експорти він має, з чим працює кожен із них і в якій області дії, а також — для плагіна, що обслуговує провайдера, — як він поводиться під час рендерингу. Плагін повідомляє те саме про себе під час завантаження. Ця умова повідомляє про розбіжність між ними.

Порівняння виконується для кожного експорту за ім’ям і лише в один бік: усе, що стверджує сутність, має збігатися, а плагін може пропонувати більше. Сутність, яка описує частину поверхні плагіна, не зобов’язана перелічувати решту, тож експорт, який плагін оголошує, а сутність пропускає, не є розбіжністю. Розбіжністю є заявлений експорт, якого плагін не оголошує, або заявлений експорт, чиї operates чи scope відрізняються від того, що повідомляє плагін. Довільний селектор не порівнюється.

Якщо сутність також містить блок поведінки рендерингу, його поля порівнюються по одному — типи вхідних даних, режим збирання, пара роздільників шаблону артефакту, анотація імені збірки, твердження про повторно використовуваний екземпляр, твердження про зв’язування через межі, твердження про пропуск записів і каталог вкладення, — і називається перше поле, що не збігається. Сутність без такого блоку повністю пропускає це порівняння.

Та сама перевірка виконується під час публікації, тож невідповідність зазвичай виявляється до публікації сутності, а не під час її завантаження збіркою.

Повідомлення, що виводяться. Заявлений експорт, якого плагін не має:

entity "<entity>" claims export "<export>", which the plugin’s describe() does not declare: wasm: entity contract claim does not match plugin describe() (сутність <entity> заявляє експорт <export>, який describe() плагіна не оголошує: wasm: заява контракту сутності не відповідає describe() плагіна)

поле заявленого експорту:

entity "<entity>" export "<export>" declares operates "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe() (експорт <export> сутності <entity> оголошує operates <claimed>, але describe() плагіна повідомляє <reported>: wasm: заява контракту сутності не відповідає describe() плагіна)

і поле поведінки рендерингу, про яке повідомляється в тій самій формі з назвою поля, що не збіглося:

entity "<entity>" declares boundary_assembly "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe() (сутність <entity> оголошує boundary_assembly <claimed>, але describe() плагіна повідомляє <reported>: wasm: заява контракту сутності не відповідає describe() плагіна)

Як виправити: виправляти потрібно твердження сутності Plugin, а не вашу сутність Aggregate чи Release. Узгодьте твердження з тим, що повідомляє плагін, — повідомлення називає обидва значення, тож напрямок зміни видно з нього самого. Якщо сутність публікуєте ви, надійний спосіб узгодити їх — згенерувати її заново з бінарного файлу; якщо ви використовуєте опубліковану сутність, виберіть версію, чиє твердження відповідає бінарному файлу, на який вона вказує, і повідомте про розбіжність тому, хто її опублікував.

A Plugin entity’s recorded command set does not match the plugin (Записаний набір команд сутності Plugin не збігається з плагіном)

Якщо плагін додає термінальні команди, ці команди записуються в його сутність Plugin. Цей запис створюється машиною, а не автором: його зчитують із плагіна й записують, тож він точно відображає бінарний файл. Ця умова повідомляє про запис, що перестав його відображати, — різницю в імені команди, у її короткій довідці або в порядку оголошення команд.

Порівняння вимагає повної рівності, і це зроблено навмисно. Твердження про можливості й експорти в інших місцях сутності курує автор: він може законно описати частину поверхні й пропустити решту, тому їх перевіряють як підмножину. Запис команд не курується, тож будь-що, крім точного збігу, означає, що запис розійшовся з тим, що плагін насправді пропонує, а майже правильний список команд якраз і спрямував би виклик не туди.

Плагін, завантажений без сутності, тут не перевіряється. Запис зберігається в сутності, тож байти, завантажені напряму, його не мають, і порівнювати немає з чим.

Повідомлення, що виводиться, називає обидва набори і спосіб записати їх заново:

wasm: plugin "<plugin>": recorded command mirror <recorded set> does not match the plugin describe() commands <reported set>; re-run aggrega plugin sync and commit the result: wasm: recorded command mirror does not match plugin describe() (wasm: плагін <plugin>: записане дзеркало команд <recorded set> не відповідає командам describe() плагіна <reported set>; повторно запустіть aggrega plugin sync і закомітьте результат: wasm: записане дзеркало команд не відповідає describe() плагіна)

Те саме порівняння під час публікації повідомляє набори без інструкції щодо повторного запису:

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() (плагін <plugin>: записане дзеркало команд <recorded set> не відповідає командам describe() плагіна <reported set>: wasm: записане дзеркало команд не відповідає describe() плагіна)

Як виправити: запишіть набір заново з бінарного файлу й закомітьте результат — повідомлення називає команду, яка це робить. Не редагуйте запис вручну, щоб він збігся: ним володіє машина, і ручна правка, яка випадково збігається сьогодні, буде виведена заново й перезаписана під час наступного запису. Якщо ви використовуєте опубліковану сутність, а не публікуєте її, сутність було опубліковано із записом, якого не підтверджує її власний бінарний файл, і це питання до її видавця.

A Plugin entity’s recorded version does not match the plugin (Записана версія сутності Plugin не збігається з плагіном)

Плагін повідомляє версію, яку записала в нього його збірка, і його сутність Plugin теж записує версію; ці два рядки мають бути однаковими. Рецепти збірки, якими збираються плагіни Aggrega, беруть цю версію з тегу, що випускає плагін, — власного тегу компілятора для плагіна, що постачається з компілятором, і власного тегу плагіна для того, що постачається окремо, — тож збірка коміту, який називає тег, повідомляє версію випуску, а збірка будь-якого іншого коміту — версію розробки, наприклад 1.0.0-3-g1a2b3c4. Ця умова повідомляє про пару, що розійшлася, і перевіряється до публікації будь-яких байтів, щоб розбіжна пара не потрапила до каталогу.

Порівняння — точний збіг рядків. Плагін, зібраний без записаної версії збірки, повідомляє порожню версію, і тоді саме цьому порожньому значенню має дорівнювати версія сутності: перевірка не трактує «версію не повідомлено» як «прийнятна будь-яка версія», бо її мета в тому, щоб версія опублікованої сутності завжди казала, що насправді повідомляє її бінарний файл.

Повідомлення, що виводиться:

plugin "<plugin>": recorded metadata.version "<recorded>" does not match the plugin describe() version "<reported>": wasm: entity metadata.version does not match plugin describe() (плагін <plugin>: записаний metadata.version <recorded> не відповідає версії describe() плагіна <reported>: wasm: metadata.version сутності не відповідає describe() плагіна)

Під час публікації відмова також називає файл сутності, .wasm і спосіб виправлення:

Plugin <plugin>: metadata.version in <entity-path> does not match the .wasm describe() version at <path> — set metadata.version to the release you are publishing and build the plugin from a clean checkout of the commit that release’s tag names, so it reports that version itself; for a new release, commit the entity with the source it releases and tag that commit first: plugin "<plugin>": recorded metadata.version "<recorded>" does not match the plugin describe() version "<reported>": wasm: entity metadata.version does not match plugin describe() (Plugin <plugin>: metadata.version у <entity-path> не відповідає версії describe() файлу .wasm за адресою <path> — установіть у metadata.version реліз, який ви публікуєте, і зберіть плагін із чистого checkout коміту, на який вказує тег цього релізу, щоб він сам повідомляв цю версію; для нового релізу спершу закомітьте сутність разом із вихідним кодом, який вона випускає, і позначте цей коміт тегом: плагін <plugin>: записаний metadata.version <recorded> не відповідає версії describe() плагіна <reported>: wasm: metadata.version сутності не відповідає describe() плагіна)

Як виправити: зробіть metadata.version сутності випуском, який ви публікуєте, і зберіть плагін із чистого checkout коміту, який називає тег цього випуску, щоб він сам повідомляв цю версію. Для нового випуску спершу закомітьте сутність разом із вихідним кодом, який вона випускає, і позначте цей коміт тегом — тег має називати коміт, що вже містить сутність. Не копіюйте в сутність версію, яку повідомляє плагін: збірка будь-якого іншого коміту повідомляє версію розробки, і її копіювання опублікувало б цю збірку під версією, якої не називає жоден тег випуску. Якщо плагін не повідомляє жодної версії, його зібрано без записаної версії; зберіть його із записаною версією.

A plugin was built from a working tree with uncommitted changes (Плагін зібрано з робочого дерева з незакоміченими змінами)

Збірка плагіна записує його версію з коміту, з якого його зібрано, а збірка з робочого дерева з незакоміченими змінами несе позначку -dirty у кінці цієї версії — 1.0.0-dirty на тегу, 1.0.0-3-g1a2b3c4-dirty після нього. Така версія є коректною семантичною версією, але вона називає коміт, який не містить зібраних байтів, тож ніхто не може відтворити те, що було б опубліковано, з версії, під якою це було б опубліковано. Публікація сутності Plugin відхиляє плагін, власна версія якого має цю позначку, ще до публікації будь-яких байтів і до звернення до реєстру; пробний запуск теж його відхиляє.

Відхиляється лише позначка. Версія розробки, зібрана з коміту, наприклад 1.0.0-3-g1a2b3c4, називає коміт, який справді містить зібране, і публікується; так само публікується попередній випуск, наприклад 1.0.0-rc.1. Перевірка плагіна щодо його сутності поза публікацією про це не повідомляє, бо збірку в процесі розробки зазвичай роблять зі зміненого дерева.

Перевірка зчитує версію, яку плагін повідомляє про власну збірку, і виконується перед порівнянням із metadata.version сутності — тож плагін, зібраний із незакоміченими змінами під сутністю, що записує чисту версію, потрапляє сюди, а не до записаної версії, що не збігається з плагіном.

Повідомлення, що виводиться, називає плагін, версію, яку він повідомляє, і спосіб виправлення:

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 за вказаним шляхом зібрано з робочого дерева з незафіксованими змінами — установіть metadata.version у файлі сутності на реліз, який ви публікуєте, і зберіть плагін із чистого checkout коміту, на який указує тег цього релізу, щоб він сам повідомляв цю версію; для нового релізу спершу зафіксуйте сутність разом із вихідним кодом, який вона випускає, і позначте цей коміт тегом: плагін зібрано з робочого дерева з незафіксованими змінами, тож жоден коміт не відтворює версію, яку він повідомляє (версія describe() плагіна закінчується на -dirty))

Як виправити: зберіть плагін із чистого checkout коміту, який називає тег випуску, щоб він повідомляв версію випуску, записану в сутності. Щоб випустити саму зміну, встановіть metadata.version сутності на новий випуск, закомітьте сутність разом зі зміною, позначте цей коміт тегом і зберіть там. Самого коміту зміни й повторної збірки недостатньо для випуску: перезібраний плагін повідомляє версію розробки, а її копіювання в сутність опублікувало б збірку під версією, якої не називає жоден тег випуску.

A Plugin entity’s recorded host functions do not match the binary (Записані функції хоста сутності Plugin не збігаються з бінарним файлом)

Плагін оголошує, які власні виклики хоста він використовує, і цей набір записується в його сутність Plugin під час публікації плагіна — його зчитують із самого бінарного файлу, а не пише автор. Під час отримання плагіна набір знову виводиться з байтів, вміст яких щойно перевірено, і порівнюється із записом. Різниця в будь-який бік зупиняє отримання.

Ця перевірка доповнює закріплення вмісту, а не повторює його, і вловлює дві речі, яких саме закріплення не вловлює: бінарний файл, опублікований не звичайним шляхом публікації, який не має запису або має запис, що не описує його власних байтів; і помилку в самому кроці запису. Закріплення встановлює, що байти є тими байтами, які було закріплено; ця перевірка встановлює, що записане про них справді їм відповідає.

Сутність без запису порівнюється з порожнім набором, що збігається з плагіном, який не використовує жодних викликів хоста, — та сама безпечна відповідність в обидва боки, тож сутність без запису не відхиляється через його відсутність.

Повідомлення, що виводиться, називає плагін, обидва набори й артефакт, з якого надійшли байти:

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 (плагін: записаний spec.runtime.hostFunctions не збігається з набором, виведеним із перевіреного артефакту .wasm: wasm: записаний перелік функцій хоста не збігається з імпортами .wasm)

Те саме порівняння під час перевірки плагіна повідомляє обидва набори без артефакту:

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 (плагін: записаний перелік функцій хоста не збігається з імпортами .wasm: wasm: записаний перелік функцій хоста не збігається з імпортами .wasm)

Як виправити: це не спричинено нічим у ваших файлах сутностей, і жодна зміна в них цього не усуне. Опублікуйте плагін заново звичайним шляхом публікації, який виводить запис із бінарного файлу й записує їх разом. Якщо ви використовуєте опублікований плагін, сутність і бінарний файл, на який вона вказує, було опубліковано неузгоджено, тож повідомте про невідповідність тому, хто його публікує, навівши обидва набори з повідомлення, — і не редагуйте запис вручну, щоб він збігся, бо його виводять, а не пише автор, і наступне виведення відкине правку.

The lockfile no longer matches what the release resolves to (Lockfile більше не відповідає тому, у що розв’язується реліз)

Lockfile релізу фіксує кожну сутність, бібліотеку й плагін, до яких реліз сягає, кожен із вибраною версією та дайджестом, а також записує самі файли релізу — реліз і кожен реліз, який він розширює, — за дайджестом їхнього вмісту. Дайджест сутності охоплює те, що несе її публікація: її документ і кожен файл, який вона називає поруч із ним, кожен за шляхом і байтами. Дайджест бібліотеки й плагіна охоплює їхні байти. Повторне розв’язання релізу дає такий самий набір, і ці два набори порівнюються. Ця умова повідомляє про розбіжність між ними.

Усі розбіжності збираються, перш ніж про будь-яку з них буде повідомлено, по всьому, що фіксує lockfile, тож один запуск показує вам повну картину, а не по одному запису за раз.

Повідомляється про такі види розбіжностей, і їх варто розрізняти, бо способи виправлення відрізняються:

  • Посилання, яке lockfile не фіксує. Реліз тепер сягає того, для чого в lockfile немає запису, — залежності, доданої після pull, що його записав. Запис називає місце, де реліз її запитує, тож сутність Recipe або FeatureRecipe, яку прив’язує сутність Manifest, повідомляється разом із записом відображення, що її прив’язує, а та, яку прив’язує рівень name, називає екземпляр або прикріплення, для якого її вибрано.
  • Зафіксоване посилання, пара якого змінилася. Lockfile фіксує одну пару «версія–дайджест», а розв’язання дало іншу. Це вендорований вміст, байти якого змінилися, або щось у робочому просторі, що змінилося: відредаговано документ сутності чи бібліотеки, відредаговано, додано або видалено файл, який називає сутність, — чарт у її джерелі, файл, який вона імпортує, entity.lock поруч із нею, — або замінено .wasm поруч із сутністю плагіна. Запис називає сутність, а не файл; звичайний aggrega pull --release <release> називає файл, що змінився під lock сутності Recipe чи FeatureRecipe, як описано в An entity reads an input the lock beside it records no pin for (Сутність читає вхідні дані, для яких lock поруч із нею не записує фіксації). Реєстр, що віддає інші байти під зафіксованою версією, тут не повідомляється: pull, який їх отримує, відхиляє їх, як описано в Fetched or cached bytes do not match the digest committed for them (Отримані або кешовані байти не відповідають зафіксованому для них дайджесту).
  • Зафіксоване посилання, якого реліз більше не сягає. Lockfile досі фіксує те, від чого ніщо в релізі більше не залежить.
  • Файл релізу, відредагований після pull. Реліз або реліз, який він розширює, більше не містить байтів, записаних для нього в lockfile. Усе, що запитує реліз, — яку версію джерела отримати, які компоненти куди розмістити, — розв’язується з вмісту файлу, тож записані фіксації можуть більше не описувати того, що він запитує тепер. Про це повідомляється тут, до будь-якого рендерингу, а не як про те, на чому впав би рендеринг: інакше відредагована версія джерела виявилася б пізніше як отримання, що не знаходить фіксації. Lockfile, який не записує жодного файлу релізу, повідомляє реліз як незаписаний, а файл релізу, який реліз більше не розширює, повідомляється як більше не прочитаний.
  • Посилання на джерело, що змінилося у віддаленому репозиторії. Джерело, записане з git ref:, фіксується на коміті, у який розв’язався ref. Кожен pull, що не є оновленням, запитує віддалений репозиторій, куди ref вказує зараз, і так само робить aggrega pull --verify, коли мережа доступна; ref, що розв’язується в інший коміт, повідомляється тут, а не приймається. Повідомляють про це лише ці двоє: збірка читає записаний коміт і нічого не запитує.

Порівнюється вміст, тож ідентичний вміст, отриманий іншим шляхом, не дрейфує: щоб умова спрацювала, мають відрізнятися байти. Для файлу релізу це включає зміну коментаря чи пробілів — так само, як для сутностей Aggregate і Manifest, які називає реліз. Для сутності це вміст того, що вона несе, тож та сама сутність, прочитана з каталогу й отримана з реєстру, не дрейфує, як і checkout, файли якого відрізняються лише бітами дозволів, зокрема бітом виконання, чи публікація, архів якої стиснуто інакше.

Повідомлення, що виводиться. Воно починається з власного речення умови, а за ним ідуть усі зібрані розбіжності, кожна з назвою своєї осі — а для сутності також її виду, оскільки сутність ідентифікується видом і URI разом, тож сутність Release, сутності Aggregate і Manifest якої мають спільне ім’я, має два записи, а редагування будь-якої з них повідомляється щодо відредагованої:

lockfile: out of date; it no longer matches what its Release resolves to: entity "<uri>" (<kind>) not in lockfile (referenced from <site>) (lockfile: застарів; він більше не відповідає тому, у що розв’язується його Release: зазначеної сутності зазначеного виду немає в lockfile, із місцем, звідки на неї посилаються) <axis> "<uri>" changed: lockfile=(<version>,<digest>) current=(<version>,<digest>) (зазначене посилання на зазначеній осі змінено: версія й дайджест у lockfile відрізняються від поточних) entity "<uri>" (<kind>) changed: lockfile=(<version>,<digest>) current=(<version>,<digest>) (зазначену сутність зазначеного виду змінено: версія й дайджест у lockfile відрізняються від поточних) <axis> "<uri>" no longer used by the release (зазначене посилання на зазначеній осі більше не використовується релізом) 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 (зазначений документ релізу було відредаговано після запису lockfile: його вміст більше не відповідає записаному дайджесту, тож закріплення можуть більше не описувати те, що він запитує; повторне розв’язання Release записує файли, які він читає, у їхньому теперішньому стані)

<site> — це місце, де реліз запитує посилання, записане як шлях до запису, що його називає, — наприклад, manifest.spec.mappings.components.name.db-primary, — до трьох таких місць у відсортованому порядку і ... після них, якщо їх більше. Посилання, розв’язання якого не записує такого місця, повідомляється без дужок.

Pull, що повідомляє про змінене посилання на джерело, називає артефакт так, як його записав автор, із chart= і module_subdir=, якщо джерело їх називає:

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> (source-artifact kind=<kind> url=<url>: посилання <ref> перемістилося — lockfile закріплює <commit>, а тепер воно розв’язується в <commit>; прийміть його нове розташування за допомогою aggrega pull —upgrade —release <release>)

Збірка виводить спосіб виправлення після записів:

run aggrega pull --release <release> to re-resolve the Release and rewrite its lockfile (виконайте aggrega pull —release <release>, щоб повторно розв’язати Release і переписати його lockfile)

Які команди зобов’язують реліз відповідати його lockfile. aggrega build порівнює перед рендерингом і зупиняється. aggrega validate --release і кожен вибір aggrega inspect, що розв’язує реліз, — типове подання, --resolved, --ir-graph і --closure, — виконують те саме порівняння, щойно розв’язано залежності релізу, і зупиняються з тим самим повідомленням і способом виправлення, нічого не записуючи у стандартний вивід; тож жодна з них не пропускає lockfile, який збірка відхиляє як розсинхронізований. Інструменти асистента build, validate з release і describe з release відмовляють на тих самих умовах. aggrega pull виконує це порівняння щодо lockfile, який збирається записати, а aggrega pull --verify — щодо того, що на диску. Команда, яка не розв’язує жодного релізу, — aggrega validate без аргументу, що тоді читає закріплення lockfile лише для того, щоб знайти батьківську сутність extends, або зі шляхом до сутності, а також aggrega inspect --raw чи --output yaml без --ir-graph, — не зобов’язана відповідати lockfile, як і реліз, поруч із яким немає lockfile. Мовний сервер редактора зупиняє на цьому свої збірки, а на запит графа повідомляє про це як про попередження щодо lockfile, водночас малюючи граф.

Як виправити: повторно розв’яжіть реліз і закомітьте переписаний lockfile. Для всього, про що повідомляє збірка, звичайний aggrega pull --release <release> — команда, яку виводить збірка, — і є повним виправленням: він розв’язує реліз у його поточному стані, переписує фіксації, що змінилися, і зберігає всі інші, тож ніщо, чого ви не торкалися, не зміщується. Якщо змінився файл у локальному джерелі сутності Recipe чи FeatureRecipe, цей pull спершу зупиняється, називаючи aggrega pin для сутності, бо записати нову фіксацію поруч із нею — крок автора; виконайте його або передайте pull --pin-sources, і pull усуне дрейф. Єдиний запис, якого звичайний pull не усуває, — посилання на джерело, що змінилося у віддаленому репозиторії, бо усунути його означає прийняти коміт, який посилання називає тепер: це робить aggrega pull --upgrade --release <release>, і запис про це каже, — а якщо entity.lock сутності Recipe записує це джерело, оновлення так само зупиняється, доки новий коміт не буде зафіксовано поруч із ним. Прочитайте записи, перш ніж це робити, бо на третьому виді варто зупинитися: посилання, якого реліз більше не сягає, зазвичай є залежністю, яку ви навмисно видалили, але якщо ви її не видаляли, змінилося щось інше, що зробило її недосяжною. Пара, що змінилася на посиланні, якого ви не торкалися, означає, що вміст у цій версії — не той вміст, який перевіряли, і це питання до того, хто його постачає, а не те, що слід приймати не дивлячись.

Pull виконує це саме порівняння з lockfile, який збирається записати, і не записує того, що порівняння відхиляє, тож щойно записаний pull lockfile проходить його для збірки з тими самими вхідними даними. Якщо ця умова повертається одразу після успішно завершеного pull, ці два запуски отримали різні вхідні дані: каталог, переданий одному з них і не переданий іншому, або конфігурацію робочого простору, відредаговану між ними. Виконуйте pull і збірку з однаковими вхідними даними.

An artifact is not at the source the build was told to find it (Артефакт відсутній у джерелі, де збірці вказано його шукати)

Посилання каталогу називає артефакт і версію. Ця умова повідомляє, що цій парі ніщо не відповідає — ні в реєстрі, на який вказує посилання, ні в локальному кеші артефактів, з якого читає збірка.

Збірка читає кеш; сама вона нікуди не звертається. Отримання — окремий крок: pull, що розв’язує реліз, завантажує все, що потрібно релізу, і записує це в кеш, а збірка потім читає те, що там є. Тому до збірки ця умова доходить як промах кешу, а до pull — як реєстр, у якому такого артефакту немає. Якщо збірку налаштовано заповнювати lockfile під час запуску, отримання, яке вона виконує, — це той самий pull.

Повідомлення, що виводяться. Реєстр без такого тегу та завантаження, яке розв’язало маніфест, але блоб вмісту якого відсутній:

oci: "<reference>:<version>": oci: artifact not found at remote source (oci: артефакт не знайдено у віддаленому джерелі)

oci: content for "<reference>:<version>": oci: artifact not found at remote source (oci: вміст: артефакт не знайдено у віддаленому джерелі)

читання кешу, яке не знайшло запису, — саме в такому вигляді це бачить збірка:

oci: cache miss for <reference>@<version>: oci: artifact not found at remote source (oci: промах кешу; oci: артефакт не знайдено у віддаленому джерелі)

і те саме для кешованого артефакту, поруч із яким немає його маніфесту:

oci: manifest cache miss for <reference>@<version>: oci: artifact not found at remote source (oci: промах кешу маніфесту; oci: артефакт не знайдено у віддаленому джерелі)

Як виправити: спершу перевірте посилання та версію — версія, якої більше не існує, і назва з одруківкою дають однакову відповідь, а повідомлення наводить обидві, щоб їх можна було звірити з каталогом. Якщо посилання правильне, артефакт не було отримано: виконайте pull для релізу, який завантажить усе, до чого сягає реліз, і заповнить кеш. Якщо робочий простір офлайн, цей pull слід виконати там, де є доступ до мережі; офлайн-збірка читає лише те, що вже є в кеші, і саме це вона повідомляє, коли в кеші цього немає.

The registry will not serve an artifact without credentials it accepts (Реєстр не віддає артефакт без облікових даних, які він приймає)

Реєстр відповів і відмовив: або облікових даних не було надано, або надані не було прийнято. Це відрізняється від реєстру, до якого взагалі не вдалося під’єднатися, — тут обмін відбувся, і відповідь була «ні».

Про це повідомляють чотири моменти, усі — під час отримання або публікації артефактів: розв’язання посилання, завантаження його вмісту, отримання переліку версій, які містить репозиторій, і перевірка облікових даних у момент їх збереження.

Повідомлення, що виводяться; кожне називає, що саме запитувалося, і цитує відповідь реєстру:

oci: resolve "<reference>:<version>": <what the registry replied>: oci: authentication required or failed (oci: розв’язання; oci: потрібна автентифікація або вона не вдалася)

перелік версій репозиторію, де натомість названо статус:

oci: tags/list "<repository>": status <code>: oci: authentication required or failed (oci: перелік тегів; статус; oci: потрібна автентифікація або вона не вдалася)

і перевірка облікових даних під час їх збереження:

oci: verify credential for "<host>": <what the registry replied>: oci: authentication required or failed (oci: перевірка облікових даних; oci: потрібна автентифікація або вона не вдалася)

Якщо збій виявляє крок, який надає спосіб виправлення, рядок завершується командою входу для хоста, який він визначив:

remediation: aggrega login <host> (or docker login <host>) before re-running aggrega pull —release <release> (виправлення: виконайте aggrega login (або docker login) для вказаного хоста перед повторним запуском aggrega pull —release)

а якщо імпорт завантажував один із базових імпортерів компілятора, — тим самим входом перед повторним запуском імпорту:

remediation: aggrega login <host> (or docker login <host>) before re-running the import (виправлення: виконайте aggrega login (або docker login) перед повторним запуском імпорту)

Класичний репозиторій чартів Helm або архів чарту, фрагмент compose і репозиторій Git, що отримуються через http або https, також повідомляють про цю умову, коли сервер відхиляє запит як неавторизований, і їхній засіб виправлення називає запис netrc, який слід додати, а не вхід, оскільки саме з цього файлу такі отримання читають свої облікові дані:

remediation: add an entry for <host> (machine <host> login <user> password <secret>) to the netrc file <path>, then run the command again (засіб виправлення: додайте до файлу netrc запис для хоста (з machine, login і password), а потім знову виконайте команду)

Як виправити: це завдання оператора, а не автора сутності — ніщо в Aggregate, Component чи Recipe цього не спричиняє. Офіційний хаб, hub.aggrega.ai, надає будь-кому те, що публікує, тож читання з нього не потребує облікових даних, а публікування в нього — потребує; інший реєстр може вимагати облікових даних і для читання. Увійдіть на хост, який називає повідомлення, — або, для джерела, що отримується через http або https, додайте запис netrc, який називає засіб виправлення, — і повторіть отримання. Якщо ви вже ввійшли, облікові дані у сховищі не ті, які цей хост приймає для цього репозиторію: увійдіть повторно, щоб оновити їх, і перевірте, що обліковий запис має доступ на читання до репозиторію, на який вказує посилання, адже приватний репозиторій відповідає саме так обліковому запису, який його не бачить. Якщо посилання вказує на неочікуваний хост, псевдонім реєстру або реєстр за замовчуванням у .aggrega-config.yaml вказує деінде.

The netrc file cannot be read (Файл netrc не вдається прочитати)

Класичний репозиторій Helm-чартів або архів чарта, фрагмент compose і Git-репозиторій, що отримується через http або https, беруть облікові дані з файлу netrc, який читається під час отримання такого джерела — командою pull, pin або збиранням, що заповнює свій lock-файл. Який файл читається і який запис відповідає на запит, описано в розділі Authentication. Ця умова повідомляє про файл netrc, який існує, але не може бути використаний: його не вдається прочитати — наприклад, це каталог або у вас немає прав на читання, — або він не відповідає формату netrc. Формат читається суворо, бо слово, прочитане не на своєму місці, зсуває всі наступні: ключове слово з помилкою перетворило б наступний за ним пароль на наступне ключове слово, і запит пішов би без облікових даних або з неправильними, хоча файл виглядав би гаразд.

Файл, якого не існує, до цієї умови не належить: він не містить облікових даних, і на запит, якому вони потрібні, відповідає відмова сервера. Файл, який можуть читати інші користувачі машини, теж до цієї умови не належить: у Linux і macOS він викликає одне попередження з назвою файлу й однаково читається.

Повідомлення називає файл, а для помилки формату — і рядок, і каже, що не так, лише в термінах самого формату — ніколи не наводячи слова з файлу, бо слово не на своєму місці може бути паролем. Діагностика не має категорії: файл netrc — це ваш власний файл облікових даних, а не документ, який читає збирання.

Повідомлення, яке видається для помилки формату, якою може бути слово там, де очікується ключове слово, ключове слово без наступного значення, login, password або account перед будь-яким записом machine чи default і слово в лапках, не закрите в тому рядку, де воно відкрите:

the netrc file could not be read (file <path>, line <line>, a word stands where a keyword is expected (machine, default, login, password, account or macdef)). Correct the file, or set NETRC to the path of another netrc file to read instead (не вдалося прочитати файл netrc (у вказаних файлі й рядку слово стоїть там, де очікується ключове слово (machine, default, login, password, account або macdef)). Виправте файл або задайте в NETRC шлях до іншого файлу netrc, який слід читати замість нього)

і для файлу, який не вдалося прочитати, із зазначенням причини:

the netrc file could not be read (file <path>, <why it could not be read>). Correct the file, or set NETRC to the path of another netrc file to read instead (не вдалося прочитати файл netrc (вказаний файл і причина, з якої його не вдалося прочитати). Виправте файл або задайте в NETRC шлях до іншого файлу netrc, який слід читати замість нього)

Як виправити: відкрийте файл, названий у повідомленні. Для помилки формату перейдіть до названого рядка: кожен запис — це machine <host> або default, за якими йдуть login <user> і password <secret>, а звичайна причина — ключове слово з помилкою або без значення. Для файлу, який не вдалося прочитати, зробіть його файлом, який ви можете прочитати і який можете читати лише ви (chmod 600). Якщо це не той файл, який ви хотіли використати, задайте в NETRC шлях до потрібного.

The registry could not be reached (Не вдалося зв’язатися з реєстром)

Обміну з реєстром не відбулося: не вдалося розв’язання імені, з’єднання або захищене рукостискання. Це протилежність реєстру, який відповів і відмовив, — тут нічого не було встановлено в жодному напрямку, тож стан артефакту на тому боці невідомий, а не відомо, що він відсутній.

Це також те, що повідомляє збій транспорту без конкретнішої причини під час отримання джерела Recipe, тож на цьому шляху це загальна відповідь «не вдалося зв’язатися з віддаленим боком», а не твердження про те, який рівень зазнав збою.

Повідомлення, що виводиться: називає джерело, яке отримується, і цитує базовий збій транспорту разом зі способом виправлення, який несе умова:

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 (oci: мережа недоступна; виправлення: перевірте мережеве з’єднання з хостом; корпоративні проксі зазвичай потребують експортованої змінної HTTPS_PROXY)

Як виправити: виправлення — справа оператора і лежить поза вашим каталогом. Перевірте, що хост із повідомлення доступний з місця, де виконується команда. Якщо середовище виходить у мережу через проксі, проксі слід експортувати в середовище, як і вказує спосіб виправлення, — проксі, налаштований лише для браузера чи менеджера пакетів, не буде підхоплено. Якщо хост доступний вручну, але не звідси, різниця зазвичай полягає в облікових даних на проксі або в сертифікаті перехоплення, який рукостискання не прийняло. Щойно артефакти потраплять у кеш, наступні збірки читатимуть кеш і мережа їм узагалі не знадобиться.

A server did not answer in time (Сервер не відповів вчасно)

Запит очікував на сервер, якому був адресований, — реєстр або будь-який інший сервер, до якого звертається команда, наприклад журнал прозорості, у якому фіксується підпис, — і був відкликаний. Запит чекає щонайбільше 30 секунд, поки сервер почне відповідь після того, як запит надіслано повністю, і щонайбільше 30 секунд на наступну частину відповіді, що вже надходить; після перевищення будь-якої з цих меж його відхиляють за цією умовою із зазначенням сервера й часу очікування. Саме такий результат дає сервер, який приймає з’єднання й ніколи не відповідає, а також адреса, яка ніколи не приймає жодного з’єднання, замість команди, що чекає без кінця. Обхід усього переліку репозиторіїв реєстру натомість чекає на кожній сторінці стільки, скільки може тривати обхід, і обмежений власною умовою, E0377.

Обмежено лише очікування. Завантаження чи вивантаження, яке триває, займає стільки часу, скільки потрібно, бо очікування вимірюється лише тоді, коли нічого не надходить. Helm-чарт, який source: сутності Recipe отримує через HTTPS, обмежено лише очікуванням початку відповіді, і про сплив цього часу повідомляється власними словами мережевої бібліотеки, а не за цією умовою. Запит, який команда й так повторює в разі тайм-ауту, — читання під час aggrega registry update, запис під час публікації, — спершу повторюється, тож відмова — це те, що лишається після його останньої спроби.

Повідомлення, що виводиться, для переліку версій, на який реєстр не відповів:

aggrega plugin add: 127.0.0.1:18471: list versions for plugin/cli/mo: oci: list tags: Get “http://127.0.0.1:18471/v2/plugin/cli/mo/tags/list”: 127.0.0.1:18471 did not answer within 30s: egress: the server did not answer in time (aggrega plugin add: 127.0.0.1:18471: перелік версій для plugin/cli/mo: oci: перелік тегів: Get: 127.0.0.1:18471 не відповів протягом 30s: egress: сервер не відповів вчасно)

і для відповіді, що обірвалася на півдорозі:

<host> stopped answering: nothing more of its answer arrived for 30s: egress: the server did not answer in time (перестав відповідати: протягом 30s більше нічого з його відповіді не надійшло: egress: сервер не відповів вчасно)

Як виправити: виправлення — справа оператора, і воно лежить поза вашим каталогом. Перевірте, що сервер, названий у повідомленні, працює й доступний з місця, де виконується команда; реєстр під навантаженням або на обслуговуванні згодом знову відповідатиме, і команду можна просто запустити ще раз. Якщо середовище виходить у мережу через проксі, перевірте, що проксі передає запит далі, а не утримує його. Час очікування фіксований; жодне налаштування його не подовжує.

A registry’s repository listing did not end in time (Перелік репозиторіїв реєстру не завершився вчасно)

Обхід усього переліку репозиторіїв реєстру тривав п’ять хвилин, не дійшовши до кінця переліку, і був зупинений. Перелік обходять дві команди: aggrega plugin add — лише тоді, коли жоден плагін не має точно того імені, яке їй передали, і вона шукає плагін, ім’я якого його містить, — та aggrega registry update, яка перелічує репозиторії реєстру, перш ніж прочитати кожен із них. Перелік, що без кінця називає нові репозиторії, і перелік, який реєстр віддає надто повільно, щоб він завершився, обидва закінчуються тут, а не тримають команду; обхід тоді не дає жодного репозиторію, тож з обрізаного переліку нічого не вибирається й не індексується. Повідомлення вказує, скільки репозиторіїв перелік назвав на момент зупинки.

Повідомлення, що виводиться, для додавання плагіна, запит якого є частиною імені:

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: жоден cli-плагін не має імені «mo», а пошук у кожному репозиторії імені, що його містить, не завершився; укажіть точне ім’я плагіна, як-от aggrega plugin add cli з іменем плагіна: обхід зупинено через 5m0s, до кінця переліку (уже названо репозиторіїв: 146): registry: перелік репозиторіїв не завершився вчасно)

Як виправити: для aggrega plugin add укажіть точне ім’я плагіна — aggrega plugin add cli moo замість aggrega plugin add cli mo, — і тоді плагін буде знайдено за цим іменем одним запитом, а перелік ніколи не обходитиметься. Для aggrega registry update причиною є перелік реєстру: з’ясуйте з тим, хто керує реєстром, що його перелік завершується, і запустіть оновлення ще раз, коли це так. П’ятихвилинна межа фіксована; жодне налаштування її не подовжує.

A registry kept asking to slow down (Реєстр продовжував просити сповільнитися)

Надто завантажений реєстр відповідає 429 Too Many Requests або 503 Service Unavailable із заголовком Retry-After, який повідомляє, скільки чекати. Кожен запит, який команда надсилає до реєстру, чекає стільки, скільки просить реєстр, — десять секунд, якщо він цього не вказує, — і надсилається знову; разом із ним чекає кожен запит до цього реєстру, і одночасно до нього надсилається менше запитів, доки він знову не відповість. Реєстр, який протягом п’яти хвилин не відповідає нічим, крім «сповільніться», відхиляється за цієї умови із зазначенням реєстру, його останньої відповіді та того, як довго він не відповідав нічим іншим; так само відхиляється й запит, власний ліміт часу якого спливає під час очікування. Тоді aggrega registry update повідомляє про цей реєстр як про непроіндексований, і він зберігає індекс, який мав до запуску.

Повідомлення, що виводиться для реєстру, який просив сповільнитися протягом п’яти хвилин:

<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 (продовжував просити сповільнитися: його останньою відповіддю було 429 Too Many Requests, і протягом 5m0s він не відповідав нічим іншим: oci: реєстр продовжував просити сповільнитися)

і для запиту, власний ліміт часу якого завершив очікування:

<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 (продовжував просити сповільнитися: його останньою відповіддю було 429 Too Many Requests, і він не відповідав нічим іншим до моменту, коли сплив власний час запиту: oci: реєстр продовжував просити сповільнитися)

Як виправити: причина — ліміт частоти запитів реєстру, а не щось, що ви написали. Реєстр, який обмежує, як швидко клієнт може надсилати запити, зазвичай обмежує все, що надходить з тієї самої адреси, тож перевірте, чи не надсилають йому запити одночасно інші команди або машини за цією адресою, і запустіть команду знову, коли вони завершаться. Якщо реєстр обслуговуєте ви, перевірте його ліміт частоти запитів. П’ятихвилинне обмеження фіксоване; немає жодного параметра, який би його подовжив.

Fetched or cached bytes do not match the digest committed for them (Завантажені або кешовані байти не збігаються з дайджестом, зафіксованим для них)

Кожен артефакт має маніфест, який фіксує дайджест його вмісту, а lockfile незалежно закріплює дайджест цього маніфесту. Обидва зобов’язання перевіряються повторним гешуванням наявних байтів і порівнянням. Саме про невдале порівняння повідомляє ця умова, і спрацьовує вона однаково як для щойно завантажених байтів, так і для байтів, прочитаних із кешу.

Дві умови, і те, яка з них спрацьовує, вказує, на якому рівні виникла розбіжність. Одна називає вміст, що не збігається з дайджестом, який фіксує його власний маніфест. Друга називає кешований маніфест, що не збігається з дайджестом, закріпленим для нього в lockfile, — ця перевірка не дає підробленому маніфесту стати авторитетом, якому довірятиме подальша перевірка вмісту. Саме закріплення робить другу перевірку змістовною: дайджест береться з lockfile, а не виводиться повторно з маніфесту в кешованих байтах, тож ці дві перевірки справді незалежні.

Далі сутність звіряється з власним рядком, а не з тим, що містять байти. Щойно байти кешованої сутності узгоджуються з її маніфестом, їх порівнюють із дайджестом, який lockfile записує для сутності; він охоплює файли, що їх містить її публікація, — кожен за шляхом і байтами, — а не стиснуті байти. Тож ті самі файли, опубліковані з іншим стисненням, усе одно узгоджуються, а інші файли під тією самою версією — ні, і про розбіжність повідомляє умова вмісту. Pull, що враховує закріплення, виконує те саме порівняння для того, що реєстр надає під закріпленою версією.

Жодна з цих перевірок не потребує мережі. Кожна — це порівняння гешів для вже наявних байтів, і саме це дає змогу повністю офлайн-збірці все одно переконатися, що вона читає саме те, що було закріплено.

Повідомлення, що виводяться. Вміст проти його маніфесту:

oci: content digest <computed> != manifest layer <committed>: oci: content digest mismatch (oci: дайджест вмісту <computed> != шар маніфесту <committed>: oci: невідповідність дайджесту вмісту)

сутність плагіна, яку маніфест фіксує в іншій позиції:

oci: config digest <computed> != manifest config <committed>: oci: content digest mismatch (oci: дайджест конфігурації <computed> != конфігурація маніфесту <committed>: oci: невідповідність дайджесту вмісту)

кешований маніфест проти закріпленого дайджесту:

oci: cached manifest digest <computed> != pinned <pinned>: oci: cached manifest digest mismatch (oci: дайджест кешованого маніфесту <computed> != закріплений <pinned>: oci: невідповідність дайджесту кешованого маніфесту)

кешована сутність проти свого рядка та реєстр, що надає інший вміст під закріпленою версією:

catalog: cached <uri> content digest <computed> does not match lockfile pin <pinned>: oci: content digest mismatch (catalog: дайджест вмісту кешованого <uri> <computed> не збігається із закріпленням у lockfile <pinned>: oci: невідповідність дайджесту вмісту)

oci: content digest mismatch: pinned entity "<uri>": registry now serves digest <computed> for the pinned version, not the pinned digest <pinned>; run aggrega pull --upgrade --release <release> to update the pin (oci: невідповідність дайджесту вмісту: закріплена сутність <uri>: реєстр тепер віддає дайджест <computed> для закріпленої версії, а не закріплений дайджест <pinned>; виконайте aggrega pull —upgrade —release <release>, щоб оновити закріплення)

Обидва обрамлюються тим, що саме читалося. Закріплена сутність, якої жодне джерело не містить за її закріпленням, — умова маніфесту, якщо розбіжність була в маніфесті запису кешу, і умова вмісту в іншому разі:

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> (закріплена сутність <uri>: жодне джерело не містить закріплених байтів <pinned> (<what each source it read held>); за доступного реєстру aggrega pull —release <release> знову завантажує закріплену версію: <the message above>)

Запис архіву зі шляхом, що виходить за межі архіву, також повідомляється за умовою вмісту, бо пакет, який так робить, не є тим пакетом, що його було зафіксовано:

path traversal entry "<name>": oci: content digest mismatch (запис із виходом за межі шляху <name>: oci: невідповідність дайджесту вмісту)

Обидва містять ту саму рекомендацію щодо виправлення, якщо крок, що їх виявляє, її надає:

remediation: run aggrega pull —upgrade —release <release> to refresh the lockfile and cache (виправлення: виконайте aggrega pull —upgrade —release <release>, щоб оновити lockfile і кеш)

Як виправити: це не спричиняє ніщо у ваших файлах сутностей, і жодна зміна в авторському коді цього не усуне. Оновіть кеш і lockfile разом за допомогою aggrega pull --upgrade --release <release>, що повторно завантажує з джерела й перезаписує обидва. Якщо це допомогло, кешовану копію було змінено або обрізано після запису. Якщо розбіжність залишається після оновлення, байти, які надає видавець, справді відрізняються від закріплених, — це перевидана версія, і з цим слід звернутися до того, хто її публікує, причому варто запитати до прийняття нового дайджесту, а не після.

A manifest carries no layer of the expected kind, or more than one (Маніфест не містить шару очікуваного виду або містить більше одного)

Маніфест артефакту перелічує його шари, а шар із вмістом вибирається за його медіатипом, а не за позицією. Саме це дає змогу артефакту об’єднувати кілька шарів — наприклад, чарт з окремим шаром походження поруч — і все одно надійно вибирати вміст.

Дві форми не залишають чого вибирати. Відсутність шару очікуваного типу означає, що маніфест описує щось інше, ніж те, як було прочитано посилання. Більше одного означає, що вибір не має відповіді, а вибір першого іноді був би правильним, а іноді непомітно хибним.

Повідомлення, що виводяться, кожне з яких називає очікуваний медіатип. Жодного:

oci: manifest has no layer of media type "<media-type>": oci: manifest has no layer of the expected content media type (oci: маніфест не має шару з медіатипом <media-type>: oci: маніфест не має шару з очікуваним медіатипом вмісту)

і більше одного, де також указано їх кількість:

oci: manifest has <count> layers of media type "<media-type>"; expected exactly one: oci: manifest has multiple layers of the expected content media type (oci: маніфест має <count> шарів із медіатипом <media-type>; очікувався рівно один: oci: маніфест має кілька шарів з очікуваним медіатипом вмісту)

Як виправити: виправлення за видавцем, а не за вами, — маніфест не є тим, що пише автор каталогу. Спершу перевірте, що посилання вказує туди, куди ви мали на увазі: посилання, що розв’язується в артефакт іншого виду, дає першу форму, бо маніфест є справжнім маніфестом чогось іншого. Якщо посилання правильне, артефакт опубліковано з маніфестом, який не описує його як той вид, за який його видають, тож передайте медіатип із повідомлення тому, хто його публікує. Публікація звичайним шляхом створює маніфест рівно з одним шаром вмісту, тож артефакт будь-якої з цих форм було зібрано в інший спосіб.

A published bundle holds no entity, or holds two (Опублікований пакет не містить жодної сутності або містить дві)

Сутність, яка оголошує файли поруч зі своїм документом — локальний chart сутності Recipe або його lock, імпортовану схему сутності Component, — публікується як .tar.gz, що пакує сутність разом із цими файлами. Зчитування такого пакета означає повторне знаходження сутності серед них, а файл, у якому її написано, може мати будь-яку назву, тож ідентифікує її преамбула сутності, яку вона містить, а не назва. Сутністю є документ на верхньому рівні пакета, чий kind: є видом сутності, що публікується; фрагмент compose, шаблон chart або маніфест Kubernetes поруч із ним сутністю не є, як і документ сутності глибше всередині дерева source/ — це вміст, який сутність постачає, а не сама сутність.

Дві форми не залишають чого вибрати, і обидві є властивостями того, як артефакт було опубліковано.

Немає документа сутності на верхньому рівні пакета. Пакет запаковано без сутності на верхньому рівні — її документ пропущено або розміщено в підкаталозі, а не поруч із файлами, які вона містить. Повідомлення перелічує, що саме є на верхньому рівні пакета, і цього зазвичай досить, щоб побачити, що сталося.

Два документи сутностей на верхньому рівні пакета. Пакет запаковано з цілого каталогу, у якому написано дві сутності, — aggrega push так ніколи не робить, бо кожна сутність містить лише оголошені нею файли, але інший клієнт може. За такого пакування кожна з їхніх опублікованих координат містить ті самі байти, тож відповідь будь-якою з них повернула б іншу сутність під запитаною назвою, і ніщо далі не змогло б цього помітити. Безпечного вибору немає, тому вибір не робиться.

Повідомлення, що виводяться, перелічують знайдене. Жодної, коли пакет містить інші файли:

bundle root carries no entity document among <file>, <file>: oci: published bundle carries no entity document (корінь пакета не містить документа сутності серед перелічених файлів: oci: опублікований пакет не містить документа сутності)

жодної, коли він не містить нічого:

bundle root carries no files at all: oci: published bundle carries no entity document (корінь пакета не містить жодних файлів: oci: опублікований пакет не містить документа сутності)

і більше однієї, із зазначенням кількості та конфліктних документів:

bundle root carries <count> entity documents (<file>, <file>): oci: published bundle carries more than one entity document (корінь пакета містить кілька документів сутностей (перелічені файли): oci: опублікований пакет містить більше ніж один документ сутності)

Як виправити: обидва випадки має усунути видавець, а не ви, і виправлення стосується каталогу версії, з якого сутність було опубліковано. Дайте кожній сутності власний каталог версії, щоб він містив одну сутність і файли, що їй належать, — таку структуру вже має кожна опублікована сутність: каталог названо за metadata.version сутності, і він розташований під власною назвою сутності. Потім опублікуйте знову з новою версією: опубліковані байти незмінні, тож повторну публікацію поверх наявної версії буде відхилено, а не виправлено. Якщо ви споживаєте, а не публікуєте, перешліть повідомлення тому, хто публікує артефакт; назви файлів у ньому вказують, який каталог розділити.

A published artifact cannot be read as an entity (Опублікований артефакт неможливо прочитати як сутність)

Зчитування сутності з координати, за якою її опубліковано, починається з байтів, які там віддає реєстр: aggrega inspect oci://… зчитує їх, щоб ви могли їх переглянути, а отримання залежності так само зчитує байти архіву, щоб знайти закріплену версію. Дві форми цих байтів не містять сутності для зчитування.

Архів, який не розпаковується. Сутність, опублікована з оголошеними файлами, публікується як .tar.gz, і байти починаються як такий архів, але потік стиснення або архів усередині нього сформовано некоректно — найчастіше тому, що його обрізано. Байти все одно відповідають дайджесту, який для них записує власний маніфест артефакту, тож вони саме такі, якими їх опубліковано: пошкодження сталося до або під час публікації, а не дорогою до вас.

Документ, який не є сутністю. Координата містить один документ, і він не розбирається, не оголошує kind: або оголошує вид, який ніколи не публікується, наприклад Release або Manifest. Тоді посилання вказує на щось, опубліковане поза каталогом, а не на сутність — наприклад, на артефакт даних, опублікований за допомогою aggrega push-artifact.

Повідомлення, що виводяться. Архів, потік стиснення якого сформовано некоректно, з помилкою, що його зупинила:

oci: unbundle gzip: <archive error>: oci: published bundle cannot be unpacked (oci: розпакування gzip: <archive error>: oci: опублікований пакет неможливо розпакувати)

архів, що обривається посеред файлу:

read <file> from the published bundle: <archive error>: oci: published bundle cannot be unpacked (зчитування <file> з опублікованого пакета: <archive error>: oci: опублікований пакет неможливо розпакувати)

документ, що оголошує вид, який ніколи не публікується:

the published document declares kind <kind>, which a registry does not publish: oci: published artifact is not an entity document (опублікований документ оголошує вид <kind>, який реєстр не публікує: oci: опублікований артефакт не є документом сутності)

і байти, що взагалі не є документом:

the published bytes do not parse as a document (<parse error>): oci: published artifact is not an entity document (опубліковані байти не розбираються як документ (<parse error>): oci: опублікований артефакт не є документом сутності)

Як виправити: архів, що не розпаковується, має замінити видавець. Опубліковані байти незмінні, тож рішенням є повторна публікація сутності з новою версією; якщо ви її споживаєте, перешліть повідомлення тому, хто її публікує. Документ, що не є сутністю, майже завжди означає, що посилання не те, яке ви мали на увазі: перевірте, що воно вказує на координату, за якою опубліковано сутність, — це посилання, яке виводить aggrega push, коли публікує сутність.

The registry could not answer what is attached to an artifact (Реєстр не зміг відповісти, що прикріплено до артефакту)

Підписи та інші вкладення прикріплюються до артефакту, а не містяться в ньому, і їх пошук — це запит до реєстру. Ця умова означає, що запит залишився без відповіді: реєстр не обслуговує такий пошук, артефакт, до якого прикріплено вкладення, не вдалося знайти, або сам запит завершився помилкою.

Це не те саме, що відповідь «нічого не прикріплено», і саме для запобігання змішуванню цих двох випадків ця умова існує. Артефакт, що справді не має підпису, розв’язується звичайно й дає порожній список. Ця ж умова означає, що список так і не отримано, тож про прикріплене нічого не відомо.

Чи зупиняється збірка, залежить від того, чи потрібен підпис, і обидва варіанти навмисні:

  • Підпис потрібен. Збірка зупиняється. Обов’язкова перевірка, яку не вдалося виконати, не пройдена, і допуск артефакту спирався б на запит, який нікому не вдалося поставити.
  • Підпис не потрібен. Збірка продовжується й повідомляє про це явно, а не мовчки. Пошук так чи інакше не дав нічого для перевірки, тож відмова відхилила б артефакт через запит без відповіді, але мовчання виглядало б як чисте отримання непідписаного артефакту, яким воно не є.

Повідомлення, що виводяться. Реєстр, який не обслуговує пошук:

oci: target does not support referrer discovery: <target kind>: oci: referrer discovery could not be completed (oci: ціль не підтримує виявлення referrers: <target kind>: oci: виявлення referrers не вдалося завершити)

сам артефакт неможливо знайти:

oci: resolve subject "<reference>": <the underlying failure>: oci: referrer discovery could not be completed (oci: розв’язання суб’єкта за вказаним посиланням: першопричина збою: oci: не вдалося завершити виявлення референтів)

і пошук завершився помилкою:

oci: list referrers of "<reference>": <the underlying failure>: oci: referrer discovery could not be completed (oci: отримання списку референтів для вказаного посилання: першопричина збою: oci: не вдалося завершити виявлення референтів)

Коли підпис не потрібен, той самий текст натомість з’являється як сповіщення:

signature verification could not run for <uri> (the registry could not answer the signature lookup and no signature is required; continuing): <the message above> (перевірку підпису для <uri> не вдалося виконати (реєстр не зміг відповісти на пошук підпису, а підпис не потрібен; продовження): <the message above>)

Як виправити: виправлення за оператором, і воно стосується реєстру, а не вашого каталогу. Якщо реєстр зовсім не обслуговує пошук вкладень, він не може зберігати підписи, тож або віддзеркальте артефакт у реєстр, який може, або припиніть вимагати підписи від цього хоста в .aggrega-config.yaml — і зафіксуйте, що саме ви обираєте, бо другий варіант означає, що підписи від цього хоста більше не перевіряються. Якщо пошук не вдався для реєстру, який його обслуговує, це проблема транспорту або дозволів саме на кінцевій точці вкладень, і повторного запуску, щойно реєстр стане доступним, цілком досить.

An artifact that must be signed carries no signature (Артефакт, який має бути підписаний, не має підпису)

Підпис є обов’язковим для артефакту, коли або власна політика підписування робочого простору охоплює його тип, або реєстр, з якого він надійшов, налаштовано вимагати підпис. Ця умова повідомляє, що реєстр відповів на пошук вкладень, нічого вкладено не було, а підпис був обов’язковим.

Дві вимоги — це одна позиція, прочитана у двох областях дії. Політика всього робочого простору вимагає підпису для типу, що входить до її області, навіть від хоста, власний запис якого підпису не вимагає, тож хост, який нічого не вимагає, не звільняє артефакт, охоплений політикою всього робочого простору.

Там, де підпис не обов’язковий, це взагалі не помилка. Артефакт перевіряється, якщо підпис є, і мовчки проходить, якщо його немає, — саме це дає змогу користуватися хостом без налаштованої позиції без зайвих формальностей.

Артефакт, тип якого не вдалося визначити, коли активна політика всього робочого простору, вважається таким, що потребує підпису, а не звільненим від нього, тож некласифікований артефакт не може оминути ввімкнену політику.

Повідомлення, що виводиться, обрамлене посиланням, яке перевірялося:

verifying the signature of <uri>: signing: no signature found for an artifact that requires one (перевірка підпису: signing: не знайдено підпису для артефакту, який його потребує)

Як виправити: виправлення — справа оператора або видавця, а не автора сутності. Якщо ви очікували, що артефакт буде підписаний, його опубліковано без підпису — перешліть посилання тому, хто його публікує, адже лише він може додати підпис. Якщо артефакт не має бути підписаним, змінювати слід вимогу: вона походить або із запису реєстру в .aggrega-config.yaml, або з політики підписування всього робочого простору, а посилання в повідомленні підказує, який хост перевірити. Вимкнення вимоги означає, що артефакти з цього хоста більше не перевіряються, тому краще звузити область дії політики до типу, ніж повністю її вимикати.

A signature does not verify (Підпис не проходить перевірку)

Підпис знайдено й перевірено, і перевірка завершилася невдачею. Це загальний негативний результат такої перевірки, що охоплює ланцюжок сертифікатів, який не сходиться до довірчого матеріалу, підпис без запису в журналі прозорості там, де він обов’язковий, підпис над іншим артефактом, ніж наявний, змінений пакет, а також пакет, перевірений за закріпленим ключем, з яким він не проходить перевірку.

Цю умову навмисно відокремлено від підпису, підписант якого не є довіреним. Той підпис структурно коректний, але зроблений не тим підписантом; цей же взагалі не пройшов перевірку. Саме таке розмежування дає змогу відрізнити «артефакт — не те, що було підписано» від «артефакт підписав хтось, кого ви не прийняли».

Те, для якого артефакту зроблено підпис, перевіряється двічі. Щойно криптографічна перевірка підпису проходить, інструментарій зчитує із самого підпису, для якого артефакту його зроблено, — те саме зчитування, за яким кожна подальша збірка звіряє записаний підпис і яке дає збірці змогу відхилити підпис, скопійований з одного артефакту на інший, нічого не перевіряючи, — і відхиляє підпис, якщо це зчитування не називає наявний артефакт або якщо підпис має форму, з якої зчитування не може визначити артефакт. Зчитуються обидві форми, які приймає pull: підпис, зроблений над самим артефактом, і підписане твердження, що його називає. Зчитування дотримується власних правил криптографічної перевірки, тож для підпису, який ця перевірка приймає, вони збігаються; відмова такого роду означає, що вони не збіглися, і про неї варто повідомити з посиланням і повідомленням, а не обходити її налаштуваннями.

Якщо запис реєстру позначає перевірку як рекомендаційну, той самий текст виводиться як сповіщення, і виконання триває.

Повідомлення, що виводяться. Від самої перевірки, з цитуванням того, що повідомив верифікатор:

signing: signature bundle does not verify: <what the verifier reported> (signing: пакет підпису не проходить перевірку: повідомлення верифікатора)

і там, де криптографічна перевірка проходить, а зчитування того, для якого артефакту зроблено підпис, не збігається:

signing: signature bundle does not verify: its cryptographic check holds, but it does not name <manifest-digest> as the artifact it was made for (signing: пакет підпису не проходить перевірку: його криптографічна перевірка успішна, але він не називає вказаний дайджест маніфесту артефактом, для якого його створено)

signing: signature bundle does not verify: its cryptographic check holds, but it is in a form from which the artifact it was made for cannot be read (signing: пакет підпису не проходить перевірку: його криптографічна перевірка проходить, але він має форму, з якої неможливо зчитати артефакт, для якого його зроблено)

кожне обрамлене посиланням, що перевіряється:

verifying the signature of <uri>: <the message above> (перевірка підпису: повідомлення вище)

а там, де запис реєстру робить перевірку рекомендаційною, — як сповіщення замість зупинки:

signature verification failed for <uri> (advisory; continuing): <the message above> (перевірка підпису не вдалася (рекомендаційно; виконання триває): повідомлення вище)

Як виправити: ніщо у ваших файлах сутностей цього не спричиняє, і жодна зміна в авторингу цього не усуває. Сприймайте це як твердження про артефакт, а не про вашу конфігурацію: наявні байти — не ті, що були підписані, або підпис не з тих, які може перевірити налаштований довірчий матеріал. Спершу отримайте артефакт повторно, оскільки обрізана чи змінена кешована копія завершується невдачею саме так, а свіже завантаження це усуває. Якщо помилка лишається й після свіжого завантаження, перешліть посилання та дослівний звіт верифікатора тому, хто публікує артефакт. Не вдавайтеся до рекомендаційного налаштування, щоб це обійти: воно залишає перевірку працювати, але не дає їй зупиняти збірку, а це свідомий вибір приймати неперевірені артефакти з цього хоста, а не спосіб щось виправити.

A signature verifies but its signer is not one the registry trusts (Підпис проходить перевірку, але його підписант не належить до тих, кому довіряє реєстр)

Підпис пройшов перевірку — ланцюжок сертифікатів сходиться до довірчого матеріалу, і запис прозорості наявний, — але ідентичність у цьому сертифікаті не збігається з жодною з ідентичностей, налаштованих як прийнятні для реєстру. Артефакт підписав справжній підписант, якого не прийнято.

Порівнюються обидві половини ідентичності, суб’єкт і видавець, що за нього поручився, і будь-яка з них може бути тією, що не збіглася. Повідомлення називає обидві, якщо їх можна зчитати із сертифіката, оскільки підписант, який пред’являє очікуваного суб’єкта від видавця, якого ніхто не прийняв, виглядає так само, як неправильний суб’єкт, якщо не показати обидві половини.

Повідомлення, що виводяться. Коли обидві половини можна зчитати:

signing: signature identity is not trusted for this registry: <what the verifier reported>; signer presented issuer "<issuer>" with identity "<subject>", but no trusted identity permits that issuer (signing: ідентичність підпису не є довіреною для цього реєстру: повідомлення верифікатора; підписувач надав вказаного видавця з вказаною ідентичністю, але жодна довірена ідентичність не дозволяє цього видавця)

і коли їх не можна зчитати — з поверненням до власного звіту верифікатора:

signing: signature identity is not trusted for this registry: <what the verifier reported> (signing: ідентичність підпису не є довіреною для цього реєстру: повідомлення верифікатора)

Як виправити: це рішення оператора, і воно справжнє, а не формальність. Порівняйте видавця та ідентичність у повідомленні з довіреними ідентичностями, налаштованими для цього реєстру в .aggrega-config.yaml. Якщо цього підписанта ви маєте намір прийняти, додайте його — запис називає ідентичність або шаблон, що їй відповідає, разом із видавцем, і обидва мають бути правильними. Якщо ні, артефакт підписав хтось, кого ви не прийняли, і додавання ідентичності лише для того, щоб збірка пройшла, — саме та реакція, якої слід уникати. Реєстри, що оголошують власну політику довіри, дають змогу закріпити її під час додавання реєстру — так можна отримати потрібні ідентичності, не переписуючи їх вручну.

A keyless trust policy names no acceptable signer (Політика довіри без ключа не називає жодного прийнятного підписувача)

Перевірка без ключа вирішує, чи приймати артефакт, зіставляючи ідентичність у його сертифікаті підпису з набором ідентичностей, налаштованих як прийнятні. Порожній набір відхиляється, а не трактується як політика: зіставлення з порожнечею або прийняло б кожного підписувача, або відхилило б кожного, і жодне з цього не є тим, що мав на увазі оператор, який налаштував перевірку.

Повідомлення, яке видається, — це власне речення цієї умови:

signing: keyless verification requires at least one trusted identity (signing: перевірка без ключа потребує щонайменше однієї довіреної ідентичності)

Як виправити: налаштуйте щонайменше одну довірену ідентичність для реєстру в .aggrega-config.yaml. Запис називає ідентичність — як точний суб’єкт або шаблон, що йому відповідає, — разом з емітентом, який за неї ручається, і обидва обов’язкові. Якщо реєстр оголошує власну політику довіри, закріплення цієї політики під час додавання реєстру заповнює набір тим, що публікує реєстр. Якщо ви взагалі не збираєтеся перевіряти підписи з цього реєстру, це інше налаштування, ніж порожній набір ідентичностей, і саме його явне встановлення про це повідомляє.

The pinned trust root cannot be read (Закріплений корінь довіри неможливо прочитати)

Корінь довіри, закріплений у робочому просторі, дає змогу перевірці без ключа виконуватися без доступу до мережі, де б вона не запускалася: це файл, вміст якого є матеріалом, з яким перевіряється кожен підпис. Ця умова повідомляє, що файл за налаштованим шляхом не вдалося перетворити на придатний матеріал довіри — його немає, він недоступний для читання або його вміст не є коренем довіри.

Збірка зупиняється, а не переходить до запасного варіанта. Закріплений корінь — це свідомий вибір перевіряти підписи за матеріалом, який ви контролюєте, тож тихе завантаження іншого замінило б цей вибір на інший і дало б результат перевірки, якого ніхто не просив.

Повідомлення, яке видається, називає шлях і цитує те, що повідомило читання:

signing: cannot load pinned trust root: <path>: <what the read reported> (signing: неможливо завантажити закріплений корінь довіри: <path>: <what the read reported>)

Як виправити: це справа оператора. Перевірте, що шлях, налаштований для кореня довіри, існує і доступний для читання тому, хто запускає команду, — шлях відносно іншого робочого каталогу, а також наявний, але недоступний для читання файл повідомляються тут. Якщо файл існує і доступний для читання, його вміст не є коренем довіри, тож замініть його актуальним пакетом із джерела, звідки ви його отримали, а не редагуйте. Якщо закріплений корінь не передбачався, змінювати слід конфігурацію: зніміть закріплення, і перевірка використає матеріал, який їй було б надано інакше.

A pinned verification key is not the key profile the verifier accepts (Закріплений ключ перевірки не відповідає профілю ключа, який приймає верифікатор)

Підписування й перевірка за утримуваним ключем використовують один профіль ключа, а ключ будь-якого іншого типу відхиляється без спроби. Це твердження про тип ключа, а не про те, чи він щось перевіряє.

Два моменти, у які це повідомляється, — різні завдання. Один — завантаження ключа для підписування, що відбувається там, де артефакт публікується; інший — перевірка підпису за ключем, закріпленим для реєстру, що відбувається там, де артефакт перевіряється. Відмова однакова в обох випадках.

Повідомлення, які видаються, кожне називає алгоритм фактично наданого ключа — an RSA key або an Ed25519 key. Закріплений ключ перевірки:

signing: unsupported held-key type: pinned key is <the key's algorithm>, want ECDSA P-256 (signing: непідтримуваний тип утримуваного ключа: закріплений ключ використовує вказаний алгоритм, очікується ECDSA P-256)

і ключ, завантажений для підписування:

signing: unsupported held-key type: held key is <the key's algorithm>, want ECDSA P-256 (signing: непідтримуваний тип утримуваного ключа: утримуваний ключ використовує вказаний алгоритм, очікується ECDSA P-256)

Як виправити: надайте ключ профілю, названого в повідомленні. Якщо ви виконуєте перевірку, ключ — це той, що закріплений для реєстру в .aggrega-config.yaml, і він має бути відкритою половиною ключа, яким підписує видавець, — невідповідність тут зазвичай означає, що закріплено не той файл, адже ключ правильного типу, але не той, повідомляється натомість як підпис, що не проходить перевірку. Якщо ви підписуєте, згенеруйте ключ названого профілю або скористайтеся шляхом без ключа, якому утримуваний ключ взагалі не потрібен.

The workspace is offline and the step needs the network (Робочий простір перебуває в режимі офлайн, а крок потребує мережі)

Робочий простір можна позначити як офлайн, і це налаштування є відмовою, а не побажанням: кожен крок, який звернувся б до мережі, відхиляється там, де він створюється, ще до будь-якого з’єднання. Рання відмова дає змогу помилці сказати «цей робочий простір офлайн», а не проявитися пізніше як тайм-аут без пояснень.

Одне рішення, прочитане в одному місці. Крок, якому потрібно заздалегідь знати, чи доступна мережа, ставить те саме запитання, що й саме завантаження, тож перевірка й операція, яку вона захищає, не можуть дійти різних висновків.

Це стосується кількох видів роботи, і всюди це та сама відмова: отримання артефакту з реєстру, отримання джерела Recipe через мережу, завантаження зовнішнього вхідного ресурсу, отримання ідентичності для підписування та завантаження матеріалу довіри. Збірка, що читає заповнений кеш, не торкається жодного з них, і саме в цьому сенс налаштування.

Якщо вся команда є мережевим обміном, відмова надходить першою, а не останньою. push, push-artifact і registry update існують для звернення до реєстру, тож вони повідомляють про це ще до читання вашої сутності чи обходу ваших репозиторіїв і називають, яке з трьох місць встановило режим — введений вами прапорець, змінна середовища або файл і ключ у ньому. Виняток — --dry-run, і він є винятком через те, що робить, а не через назву: він повідомляє, що опублікував би, і нічого не викликає, тож це форма публікації, безпечна в режимі офлайн, і вона продовжує працювати.

Повідомлення, яке видається, містить власний спосіб усунення і є власним реченням цієї умови:

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: доступ до мережі відхилено, оскільки робочий простір офлайн; усунення: передайте —offline=false, щоб дозволити мережу для цього одного запуску, або очистьте ключ верхнього рівня offline у файлі конфігурації (або AGGREGA_OFFLINE), щоб дозволити її надалі; якщо робота — це збірка, якій потрібен вміст, якого немає на машині, спершу виконайте aggrega pull —release <release> з підключеного середовища, щоб заповнити кеш)

Обрамлене тим, що потребувало мережі, — наприклад, отриманням джерела Recipe:

sourceresolver: kind=<kind> url=<url> version=<version>: <the message above>

Додавання офіційного хабу в робочому просторі офлайн не відхиляється: хаб додається на його вбудованій базовій конфігурації, а сповіщення каже, що хаб не запитували про його політику довіри, бо робочий простір офлайн.

Як виправити: повідомлення називає три способи, і який із них застосувати, вирішуєте ви. Якщо режим встановлено, а вам потрібно обійти його для однієї команди, передайте --offline=false; саме для цього прапорець і призначений, і це єдина відповідь, доступна тому, хто не писав файл конфігурації сам. Якщо робочий простір має бути офлайн, виправляти слід відсутній вміст: виконайте pull там, де є доступ до мережі, щоб кеш містив усе, чого досягає release, і тоді офлайн-збірці більше нічого не знадобиться. Якщо він взагалі не має бути офлайн, очистьте налаштування в його джерелі — ключ верхнього рівня offline у .aggrega-config.yaml або змінну середовища, названу в повідомленні; саме змінна найчастіше підводить, бо її немає в жодному файлі. Зауважте, що робочий простір офлайн взагалі не може підписувати шляхом без ключа, оскільки видача сертифіката та його запис — мережеві операції, що не мають офлайн-форми.

Під час побудови топології

Коли кожна сутність Component має розв’язаний Recipe, компілятор зшиває Components у граф IR, читаючи блок uses: кожної сутності Component і зіставляючи цілі та прикріплення функцій.

Завислa ціль uses

Ребро uses: називає цільовий компонент, якого немає в розв’язаній топології. Зупинка не залежить від походження: ребро сутності Aggregate, написане розробником, і ребро, з’єднане в сутності Release, перехоплюються однаково. Зависла ціль — це фатальна зупинка, а не тихе відкидання: інакше ребро до неіснуючої цілі зникло б, і впроваджені значення споживача під час розгортання тихо залишилися б порожніми. Це структурний відповідник описаної нижче зупинки через неоголошений сокет: хоч би до якого сокета було під’єднано з’єднання, його ціль має розв’язуватися в наявний компонент, перш ніж ребро пройде перевірку типів.

Повідомлення, що виводиться. Спершу йде відмова, потім ціль, якій нічого не відповідає, і сокет, до якого було під’єднано з’єднання, а потім — що з цим робити:

uses edge target does not exist ("<target>", wired into socket "<socket>"). Point the target at a component the Aggregate declares, or declare a component under that name. (ціль ребра uses не існує ("<target>", під’єднано до сокета "<socket>"). Спрямуйте ціль на компонент, який оголошує Aggregate, або оголосіть компонент під цим іменем.)

Знахідка прив’язується до написаного запису, якого вона стосується, у документі, де цей запис написано, тож з’єднання, проведене власним блоком uses: компонента, з’єднання, спроєктоване прикріпленням, і з’єднання, під’єднане в сутності Release, кожне повідомляються у своєму блоці. Кожне хибне з’єднання повідомляється як окрема знахідка, тож одна збірка називає їх усі, а не зупиняється на першому.

Як виправити: оголосіть відсутній цільовий компонент або виправте ім’я цілі в записі uses:, щоб воно відповідало наявному компоненту.

Два з’єднання одного компонента під одним псевдонімом

Компонент читає кожне зі своїх з’єднань за його псевдонімом — ключем, під яким з’єднання записано, або, для з’єднання, записаного як елемент списку, власним іменем його цілі. Шаблон сутності Recipe читає з’єднання компонента лише за псевдонімом, а перевірка (assertion) читає їх за сокетом, а потім за псевдонімом, тож два з’єднання одного компонента під одним псевдонімом ділили б одну комірку щонайменше в одному з цих поглядів: пізніше зайняло б її, а інше було б відсутнє в тому, що бачить шаблон або перевірка. Тому один псевдонім позначає одне з’єднання компонента — незалежно від того, у який сокет підключено кожне з них, що його створило (власний блок uses: компонента, блок uses: долучення на будь-якому рівні або запис сутності Release для окремого ребра) і яка його ціль. Така пара зупиняє збирання, щойно граф стає остаточним, до виконання будь-якої перевірки й до будь-якого рендерингу.

Пара виникає з написання, яке окремо на кожній поверхні є допустимим: власний запис компонента і запис прикріплення на одному сокеті з одним псевдонімом; список, що двічі називає одну ціль (models: [llama, llama]); один псевдонім, написаний на двох сокетах (models: { local: … } поруч із databases: { local: … }); два прикріплення, що під’єднують один псевдонім; або запис сутності Release, що проводить з’єднання на сокеті, який Aggregate залишив незв’язаним, під псевдонімом, уже використаним в Aggregate на іншому сокеті. Дві сусідні форми ніколи не доходять до цієї зупинки: один ключ, написаний двічі в одному блоці записів із ключами, не дає документу завантажитися, а запис сутності Release на сокеті й псевдонімі, які вже провів інший блок, налаштовує це з’єднання — або, якщо називає іншу ціль, зупиняє збірку як перепризначення цілі — а не проводить друге.

Повідомлення, що виводиться. Спершу йде відмова, потім псевдонім і компонент, потім сокет цього з’єднання, його ціль і місце, де написано його запис, потім те саме для з’єднання, яке вже має цей псевдонім, а потім — що з цим робити:

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>", у компоненті "<component>", це з’єднання під’єднано до сокета "<socket>", з ціллю "<target>", записано в "<file>", за шляхом "<key path>", з’єднання, що вже має цей псевдонім, під’єднано до сокета "<socket>", з ціллю "<target>", записано в "<file>", за шляхом "<key path>"). Дайте одному з двох з’єднань власний псевдонім: компонент читає кожне з’єднання за його псевдонімом, незалежно від сокета, до якого його під’єднано. Елемент списку бере ім’я своєї цілі як псевдонім, тож ціль, указану двічі, слід указати один раз або записати як два записи з ключами під двома псевдонімами.)

Якщо обидва з’єднання написано за одним шляхом ключів — у списку, що двічі називає одну ціль, — кожне також називається своєю позицією в цьому списку, list entry "2" поруч із list entry "1", і лише це розрізняє два записи.

Знахідка прив’язується до власного запису пізнішого з’єднання — проведеного другим, тобто того, яке інакше зайняло б комірку псевдоніма, — у документі, де цей запис написано. Тож запис сутності Release або прикріплення, яке пише Release, фіксується як помилка експлуатації, а запис в Aggregate — як помилка розробника. Кожне хибне з’єднання повідомляється як окрема знахідка, тож одна збірка називає їх усі.

Деякі форми називаються менш точно. Ім’я прикріплення, оголошене на кількох рівнях — скажімо, на компоненті й на підсистемі, що його містить, — проводить з’єднання з кожного блоку оголошення, і збірка записує обидва лише під іменем прикріплення. Тоді обидва з’єднання називаються в одному з блоків оголошення — у власному блоці прикріплень компонента, якщо ім’я оголошено там, — і жодне не має позиції в списку. Те саме стосується імпортованого Aggregate, де блоки оголошення — блок компонента й блок однієї з власних підсистем модуля — називаються у власному документі модуля. У кожній із цих форм пару все одно відхилено.

Як виправити: дайте одному з двох з’єднань власний псевдонім. Для списку, що двічі називає одну ціль, укажіть ціль один раз або запишіть два з’єднання як записи з ключами під двома псевдонімами. Для одного псевдоніма на двох сокетах перейменуйте один із двох ключів. Прикріплення, що під’єднує сокет під псевдонімом, який компонент уже використовує, бере інший ключ у власному блоці uses:.

uses: socket not declared in the owning entity’s usesSchema (Сокет uses не оголошено в usesSchema сутності-власника)

Блок uses: називає сокет, який сутність, що володіє поверхнею, не оголошує у своїй usesSchema, на одній із двох поверхонь, де можна називати лише оголошений сокет: у uses: приєднання Feature, де сокет має бути оголошений на приєднаній Feature, і в покрайовому uses: сутності Release, де він має бути оголошений на споживчій Component. Release може під’єднувати або налаштовувати ребра лише в межах сокетів, які вже оголошує usesSchema сутності Component.

Поверхню прикріплень перевіряють на кожному рівні, де записано прикріплення: на компоненті, на підсистемі — сутності Aggregate або модуля, який вона імпортує, — на межі сутності Release і в записі компонента сутності Release, зокрема в записі для компонента, який додає модуль. Власні оголошення модуля перевіряються, щойно зібрано композицію, яка його імпортує, і знахідка називає сутність Aggregate модуля та ключ у її документі.

Власний блок uses: компонента навмисно не є однією з цих поверхонь, тож ця зупинка для нього не спрацьовує. Розробник володіє топологією, яку оголошує Aggregate, і може назвати сокет, який каталог не оголошував; мовчання каталогу щодо сокета означає, що з’єднання не було передбачене, а не що воно заборонене. Такий сокет допустимий, і його ребро будується — він втрачає лише селектор і покрайовий контракт, які несе оголошений сокет. Тому неправильно написана назва сокета там є не зупинкою, а окремим ad-hoc з’єднанням, і про неї повідомляється попередженням, що називає обидва написання, — див. warnings.md «Uses-socket near-miss lint».

Повідомлення, що виводиться:

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>") (невідомий сокет uses: назвіть сокет, який сутність оголошує у своїй usesSchema, — лише власний блок uses компонента може називати сокет, який каталог не оголосив; зазначаються Release, місце, тип компонента, назва сокета й оголошені сокети)

Гілка приєднання називає тип Feature замість типу компонента; приєднана Feature, яка взагалі не оголошує usesSchema, натомість повідомляє, що оголошення uses: для неї не дозволені.

Як виправити: у приєднанні виправте назву сокета на ту, яку оголошує приєднана Feature, або оголосіть цей сокет у usesSchema сутності Feature. У покрайовому записі Release виправте назву сокета на ту, яку оголошує споживча Component, — Release не може ввести сокет, якого Component не оголошує, і підтримуваний шлях — перенести оголошення в сутність каталогу. Якщо сутність каталогу взагалі не оголошує usesSchema, вона не приймає жодних оголошень uses: на цій поверхні — видаліть блок.

З’єднання несе приєднання під назвою, для якої його сокет не оголошує слота

Блок features: запису з’єднання називає приєднання, якого не оголошує жоден слот сокета з’єднання. Приєднання, які несе з’єднання, утворюють закриту множину: сокет, через який під’єднано з’єднання, оголошує в featuresSchema у записі usesSchema споживчої Component кожен слот, який може заповнити з’єднання на ньому, а приєднання під будь-якою іншою назвою відхиляється під час завантаження збірки. Сокет, що не оголошує featuresSchema, не допускає приєднань на своїх з’єднаннях, як і сокет, який Aggregate називає без оголошення його в Component, — такий сокет не оголошує слотів.

Це правило діє для обох документів, що записують вкладення з’єднання: запису з’єднання в Aggregate під uses: компонента та запису Release для окремого ребра uses:. Для компонента, який додає вкладений агрегат, назви розробника перевіряються, щойно прочитано власний документ вкладеного агрегата, і результат називає файл цього документа та запис компонента в ньому. Назви Release перевіряються після сплощення композиції для кожного компонента, щодо якого пише Release, і результат називає власний запис Release — усередині межі, у якій він розташований, або під записом маршрутизації, що досягає компонента вкладеного агрегата. Запис Release на сокеті, який Component не оголошує, повідомляється зупинкою щодо неоголошеного сокета вище, яка перелічує наявні сокети, а не цією.

Повідомлення, що виводиться. Спершу відмова, потім документ і запис, назва приєднання, з’єднання, сокет, компонент і слоти, які оголошує сокет, — а потім що з цим робити:

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. (з’єднання несе вкладення під назвою, для якої його сокет не оголошує слота (Aggregate, за шляхом запису, назва вкладення, на з’єднанні, через сокет, компонента, сокет оголошує слоти). Запишіть вкладення під одним зі слотів, які оголошує сокет, або оголосіть цей слот у featuresSchema сокета в Component.)

Якщо назва відрізняється на одне редагування від слота, який оголошує сокет, — переставлений, пропущений, подвоєний або неправильний символ, тобто типова форма друкарської помилки, — цей слот називається одразу після неї, тож імовірне задумане написання опиняється в тому самому реченні:

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>", …) (з’єднання несе вкладення під назвою, для якої його сокет не оголошує слота (Release, за шляхом запису, “credentail”, близько до оголошеного слота “credential”, на з’єднанні, …))

Окреме попередження для такої назви не виводиться. У власному блоці features: компонента назва, що на одне редагування відрізняється від оголошеного слота, допустима і спричиняє лише попередження з розділу «An attachment name is one edit from a declared slot» нижче; на з’єднанні назва відхиляється, і відмова сама містить цю пару.

Якщо сокет не оголошує слотів, список відсутній, а порада звучить так: «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.» (Сокет не оголошує слотів, тож жодне з’єднання, під’єднане через нього, не несе приєднання: видаліть приєднання або оголосіть слот у featuresSchema сокета на Component.) Якщо Component узагалі не оголошує сокет, вона звучить так: «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.» (Тип компонента не оголошує цей сокет, тож сокет не оголошує слотів і жодне з’єднання, під’єднане через нього, не несе приєднання: видаліть приєднання або оголосіть сокет і його слот в usesSchema сутності Component.)

Про кожне порушне приєднання повідомляється окремою знахідкою, тож одна збірка називає їх усі.

Як виправити: запишіть приєднання під слотом, який оголошує сокет; або, якщо з’єднанню потрібен слот, якого сокет не має, оголосіть його в featuresSchema сокета на Component. На сокеті, якого Component не оголошує, оголосіть сокет і його слот в usesSchema сутності Component або видаліть приєднання.

Release retargets a developer-declared edge (Release перенаправляє ребро, оголошене розробником)

Запис uses: для окремого ребра в сутності Release називає ціль, яка відрізняється від цілі, яку розробник уже під’єднав для того самого сокета й псевдоніма. Сутність Release може налаштовувати ребро, оголошене розробником (задавати infra для ребра, називаючи ту саму ціль або пропускаючи її), і може під’єднувати ребро до оголошеного, але не прив’язаного сокета, проте не може перенаправляти ребро, оголошене розробником, — розробник володіє архітектурою, яку створив.

Обидві цілі порівнюються так, як їх записано, а не так, як вони розв’язуються. target: може називати опублікований псевдонім субагрегату замість ідентифікатора компонента, і цей псевдонім розв’язується в компонент, для якого модуль його публікує, — тож запис сутності Release, що повторює той самий псевдонім, який написав розробник, є налаштуванням і приймається, так само як повторення звичайного ідентифікатора компонента.

Ребро зберігає ціль, яку дав йому розробник, незалежно від того, чи спрацьовує ця зупинка, і infra: із запису сутності Release до нього не застосовується. Відхилене перенаправлення ніколи не застосовується частково.

Повідомлення, що виводиться. Спершу йде відмова, потім ціль, яку оголосив розробник, ціль, яку назвала сутність Release, і сокет — а потім що з цим робити:

release edge retargets a developer-declared edge (declared target "<declared-target>", target the Release names "<release-target>", wired into socket "<socket>"). Drop the target from the Release entry to configure the connection as it was declared, or change the target where the connection is declared. (ребро release перенацілює ребро, оголошене розробником (оголошена ціль «<declared-target>», ціль, яку називає Release, «<release-target>», підключено до сокета «<socket>»). Приберіть ціль із запису Release, щоб налаштувати з’єднання так, як його оголошено, або змініть ціль там, де з’єднання оголошено.)

Знахідку розташовано на створеному записі, у якому оголошено з’єднання, у документі, що його оголосив. Кожен хибний запис повідомляється як окрема знахідка, тож одна збірка називає їх усі, а не по одному за запуск.

Як виправити: приберіть відмінну target із запису uses: сутності Release, щоб налаштувати наявне ребро (лише infra для ребра), або, якщо з’єднання справді належить іншому сокету, під’єднайте його через сокет, який розробник залишив неприв’язаним. Щоб змінити саму ціль, змініть її в сутності Aggregate, де створюється топологія.

Release per-edge configuration has no edge to apply to (Конфігурації ребра в Release ні до якого ребра застосовуватися)

Запис uses: для окремого ребра в сутності Release задає infra:, вкладення в features: або і те, і те, але після того, як усі ребра збірки побудовано, жодного ребра для споживача, сокета й псевдоніма, які він називає, не існує.

Запис сутності Release може робити дві речі: під’єднувати ребро і налаштовувати його, а що саме він робить, визначається тим, чи називає він target:. Запис із ціллю створює ребро, яке налаштовує. Запис без цілі налаштовує ребро, яке вже має існувати, — оголошене розробником у сутності Aggregate або додане вкладеною сутністю Feature. Тож запис, що не називає цілі й не збігається з жодним наявним ребром, ні до чого не застосовується: блок infra: і вкладення під ним ніколи не потрапляють у жоден вивід. Збірка зупиняється замість того, щоб приймати написане, яке нічого не робить, бо інакше успішна збірка сприймається як підтвердження того, що інфраструктуру застосовано, а з’єднання несе те, що на нього поклав запис.

Псевдонім є частиною того, що називає запис, тож запис, який налаштовує псевдонім, ніколи не оголошений розробником, не досягає жодного ребра, навіть коли сокет прив’язано під іншим псевдонімом. Так само і запис, що називає компонент, який сутність Aggregate не оголошує.

Про дві суміжні умови повідомляють власні зупинки, а не ця, бо кожна може сказати вам більше. Сокет, який usesSchema сутності Component-споживача не оголошує, повідомляється як неоголошений сокет, що може перелічити сокети, які існують. target:, що не називає жодного компонента, повідомляється як висяча ціль. Компонент, вимкнений перемикачем active:, за задумом забирає свої ребра з собою, тож запис, що залишився на ньому, приймається, а не зупиняє збірку.

Повідомляється про кожен хибний запис. Сутність Release із кількома записами, що не досягають жодного ребра, зупиняється з однією такою зупинкою на кожен запис в одній збірці, у порядку, в якому їх оголошує документ, а не повідомляє про перший і залишає решту наступній збірці.

Повідомлення, що виводиться, коли запис називає наявний компонент. Воно містить шлях до самого запису, тож називається рядок, який треба редагувати, а не компонент, що його містить:

release per-edge configuration has no edge to apply to (Release <release-name>, at .spec.boundaries.<boundary>.components.<consumer>.uses.<socket>.<alias>, "<consumer>", on socket "<socket>", under alias "<alias>"). Give the entry a target to wire the edge, or remove it: an entry with no target configures an edge that must already exist. (конфігурація ребра в release не має ребра, до якого її можна застосувати (Release <release-name>, у .spec.boundaries.<boundary>.components.<consumer>.uses.<socket>.<alias>, «<consumer>», на сокеті «<socket>», під псевдонімом «<alias>»). Задайте запису ціль, щоб підключити ребро, або видаліть його: запис без цілі налаштовує ребро, яке вже має існувати.)

Сутність Release, що називає свої компоненти на верхньому рівні, а не під межами, має форму, яку написав її автор, — .spec.components.<consumer>.uses.<socket>.<alias>, — а компонент, названий у записі маршрутизації aggregates:, називається через цей запис, під локальною назвою, яку він там має.

Коли запис називає компонент, який сутність Aggregate не оголошує, зупинка надходить раніше у збірці й звучить так, називаючи те, що задає запис, — infra, features або 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 (конфігурація ребра в release не має ребра, до якого її можна застосувати: ребро release <consumer>/<socket>/<alias> задає <infra|features|infra and features> для <consumer>, який не є компонентом у топології)

Як виправити: додайте до запису target:, що під’єднує ребро й застосовує до нього конфігурацію; виправте псевдонім на той, який сутність Aggregate оголосила для цього з’єднання, щоб запис налаштовував наявне ребро; виправте назву компонента на ту, яку оголошує сутність Aggregate; або видаліть запис, якщо конфігурація більше не потрібна.

A Release attachment takes the name of a connection’s attachment (Вкладення сутності Release бере ім’я вкладення з’єднання)

Сутність Release записує вкладення під іменем, яке має вкладення на одному з з’єднань компонента: псевдонім з’єднання, крапка і слот, який заповнює вкладення, — gpt.credential для вкладення, що заповнює слот credential на з’єднанні gpt. Вкладення з’єднання записується в записі цього з’єднання — у з’єднанні сутності Aggregate під uses: компонента або в записі uses: для окремого ребра в сутності Release для того самого з’єднання — і стає вкладенням компонента-споживача під цим складеним іменем. Сутність Release записує вкладення ще у двох областях, ключі яких можуть містити крапку, тож складене ім’я можна записати й там:

  • Власний блок features: запису компонента, який приєднує вкладення до цього компонента.
  • Власний блок features: межі, який приєднує вкладення до кожного компонента, розміщеного в цій межі або в межі, вкладеній у неї, — зокрема до компонентів підагрегату, які межа маршрутизує, не називаючи їх. Ключ там спричиняє зупинку, коли він збігається зі складеним іменем на будь-якому компоненті, якого він досягає, незалежно від того, чи вказує він type:.

Збірка зупиняється, а не зливає будь-яке з них із вкладенням з’єднання, бо тоді жоден документ не показував би всього, що збірка з ним робить. Слот сокета заповнюється для кожного з’єднання окремо, власним записом з’єднання, і ніколи — вкладенням, що каскадно спадає на нього з ширшої області. Ключ із крапкою, який не збігається з жодним вкладенням з’єднання компонентів, яких він досягає, є звичайним іменем вкладення і не відхиляється.

Перевірка охоплює вкладення, яке будь-який із документів поставив на з’єднання, а також компонент, який додає підагрегат, так само як і компонент, оголошений у сутності Aggregate.

Повідомлення, що виводиться, для ключа в записі компонента. Спершу йде відмова, потім сутність Release і запис компонента, ключ, який записала сутність Release, компонент, з’єднання, сокет і слот — а потім запис з’єднання, у якому його слід записати:

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.

Повідомлення, що виводиться, для ключа на межі. Воно називає блок вкладень межі та компонент, з’єднання якого несе вкладення:

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.

Про ключ на межі, що досягає кількох компонентів, з’єднання яких несуть складене ім’я, повідомляється окремо для кожного з них, бо кожне з’єднання — це окреме редагування.

Знахідка прив’язується до блоку, у якому записано ключ, — запису компонента або features: межі, — бо сам ключ містить крапку, а позиція не може адресувати такий ключ; натомість ключ названо в повідомленні. У сутності Release, яка називає межі, запис компонента має вигляд .spec.boundaries.<boundary>.components.<component>, компонент, названий у записі маршрутизації aggregates:, називається через цей запис, під локальним іменем, яке він там має, а блок вкладеної межі має вигляд .spec.boundaries.<outer>.boundaries.<inner>.features.

Як виправити: перенесіть вкладення в запис сутності Release для цього з’єднання — uses.<socket>.<alias>.features.<slot> під компонентом, — записавши там лише infra:, щоб задати розмір вкладенню, яке оголошує сутність Aggregate, або type: і infra: для вкладення, яке створює лише сутність Release; потім видаліть ключ із крапкою з features: компонента або межі. Ключ на рівні межі, призначений для з’єднань кількох компонентів, записується по одному разу на кожному з цих з’єднань.

A Release connection attachment names no Feature type (Вкладення з’єднання сутності Release не вказує тип Feature)

Запис per-edge uses: сутності Release ставить вкладення на з’єднання під слотом, для якого сутність Aggregate не оголошує вкладення на цьому з’єднанні, і не вказує type:. Вкладення, яке сутність Release записує на з’єднанні, — одне з двох. Воно задає розмір вкладенню, яке сутність Aggregate вже оголошує на тому самому з’єднанні, і не вказує типу, бо його вказує оголошення в сутності Aggregate; або це вкладення, яке створює лише сутність Release, і тоді запис сутності Release — єдине місце, звідки може взятися його тип Feature. Без нього ніщо не може вибрати FeatureRecipe для вкладення.

Перевірка охоплює компонент, який додає підагрегат, так само як і компонент, оголошений у сутності Aggregate. Компонент, вимкнений перемикачем active:, забирає з собою свої з’єднання, тому запис, що залишився на одному з них, не перевіряється.

Повідомлення, що виводиться. Спершу йде відмова, потім сутність Release і запис з’єднання, слот, з’єднання, сокет і компонент — а потім що з цим робити:

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.

Про кожне порушне приєднання повідомляється окремою знахідкою, тож одна збірка називає їх усі.

Як виправити: додайте type:, що називає Feature, який приєднує вкладення; або, якщо вкладення має оголошувати розробник, оголосіть його в записі з’єднання сутності Aggregate з його values: і залиште в записі сутності Release лише infra:.

Component identity cannot be stamped on what it emits (Ідентичність компонента не можна проставити на тому, що він виводить)

Ідентичність компонента — це не лише ключ у вашій сутності Aggregate, а й ім’я всередині кластера. Нею позначається кожен ресурс, який виводить компонент, під aggrega.ai/component-id і app.kubernetes.io/name, а синтезатори робочих навантажень називають за нею те, що виводять. Тож ідентичність має бути ім’ям, яке прийме ціль, і таким, що означає саме те, що каже.

Ім’я, яке ви написали, потрапляє у вивід точно так, як ви його написали, і саме завдяки цьому ім’я у вашій сутності Aggregate — це ім’я, яке можна шукати у вашому кластері. Це варте того, і тому ідентичність, яку ціль відхилила б, повідомляється тут, а не мовчки виправляється на щось, чого ви ніколи не писали.

Виняток становить один символ, і його ви написати не можете: крапка, що з’єднує ім’я модуля з ім’ям компонента всередині нього. Її вилучено з усіх імен, які ви пишете, саме для того, щоб це з’єднання було однозначним, і перед проставленням її прибирають з ідентичності: data-layer.main-db проставляється як data-layer-zdmain-db. Це не коштує жодного імені, яке хтось набрав, і саме це дає змогу взагалі проставити компонент, який вносить імпортована сутність Aggregate: крапка не є символом, який приймає ім’я Service, а в адресі всередині кластера вона відокремлює сервіс від його простору імен, тож ім’я з крапкою, передане споживачеві як хост, вказувало б на інший сервіс, а не спричиняло помилку.

Відхиляються дві форми.

Ідентичність, яку не може передати алфавіт позначення. Ідентичність записується у значення мітки, яке має кожен виведений ресурс, а цей алфавіт допускає літери, цифри, -, _ і . та вимагає, щоб значення починалося й закінчувалося літерою або цифрою. Правила для написаних імен близькі до цього, але не тотожні — вони дозволяють імені починатися або закінчуватися на - чи _, — тож _api і api- обидва можна написати, але жодне не можна проставити.

Допустима довжина імені тут не перевіряється. Це питання цілі, у яку розгортається компонент, і різні цілі відповідають по-різному: ця умова охоплює форми, яких не могла б передати жодна ціль. Про ім’я, відхилене через довжину, натомість повідомляє власна відмова цілі, яка містить причину цієї цілі й довжину, яку вона прийняла б.

Ідентичність, що починається так, як складена. Ресурси, які виводить Feature, не можна позначити написаним вами ім’ям компонента, тож Aggrega складає для них ідентичність із частин, які ви написали, після фіксованого початку, що вказує, де приєднано Feature. Якщо Feature приєднано до одного компонента, ідентичність складається з цього компонента й ключа, під яким приєднано Feature, і починається з cfr--. Якщо її приєднано до цілої межі, ім’я жодного окремого компонента не підходить, тож ідентичність складається зі шляху межі та імені, під яким приєднано Feature, і починається з bfr--. Саме початок підказує читачеві, з якого з двох варіантів походить ресурс, а не з компонента. Тому і bfr--, і cfr-- зарезервовано на початку ідентичності компонента. Компонент з іменем bfr--api або cfr--api був би позначений так само, як складений, і ніщо у виведеному результаті не дало б їх розрізнити. Зарезервовано лише повний початок: компонент з іменем bfr, cfr, bfr-api або bfrontend — звичайне ім’я, і він збирається.

Перевірка читає ідентичність, яку компонент фактично має, а для компонента, внесеного імпортованою сутністю Aggregate, це кваліфікована ідентичність — ім’я модуля, крапка і власне ім’я компонента. Тож два імені, кожне з яких прийнятне окремо, можуть з’єднатися в неприйнятну ідентичність: модуль з іменем bfr--x і компонент y у ньому з’єднуються в bfr--x.y, що починається так, як складена ідентичність. Зупинка називає з’єднану ідентичність, указуючи на написаний вами ключ.

Повідомлення, що виводиться, для ідентичності, яку ціль відхилила б:

component identity cannot be the name its emitted resources are stamped with: rename the component (Aggregate, at <field-path>, "<identity>", which must "<rule>") (ідентичність компонента не може бути іменем, яким позначаються ресурси, що він генерує: перейменуйте компонент (Aggregate, за шляхом поля, ідентичність, яка мусить відповідати правилу))

і для ідентичності, що починається так, як складена, де <opening> — той із зарезервованих початків, якому відповідає ім’я:

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>") (ідентичність компонента не може бути іменем, яким позначаються ресурси, що він генерує: перейменуйте компонент (Aggregate, за шляхом поля, ідентичність, яка не повинна починатися із зарезервованого початку))

Як виправити: перейменуйте компонент у всіх місцях, де його названо, — у сутності Aggregate, що його оголошує, і в сутності Release, що його розміщує та налаштовує. Дайте йому ім’я, яке починається й закінчується літерою або цифрою і не починається ні з bfr--, ні з cfr--. Перейменування компонента змінює ім’я, яке його ресурси мають у кластері, тож для вже розгорнутого застосунку ставтеся до нього як до будь-якого іншого перейменування ресурсу.

The target will not accept a name derived from an authored identity (Ціль не прийме ім’я, похідне від авторської ідентичності)

Кожна ціль виводить власні імена з ідентичності компонента: інсталятор чартів виводить ім’я релізу, оркестратор контейнерів виводить імена сервісів. Ця зупинка — це повідомлення цілі про те, що вона не може використати одне з них.

Aggrega не містить правил іменування жодної цілі. Вона не знає, якою довгою може бути назва, які символи допускає ціль або чого граматика цілі вимагає на початку імені, — і свідомо не знає, бо це відрізняється залежно від цілі, від виду ресурсу, на який потрапляє ім’я, а іноді й від окремого сервісу в межах одного провайдера. Тому перш ніж ім’я буде остаточно визначено, компілятор запитує провайдера, який рендеритиме компонент, і ця зупинка повідомляє відповідь провайдера. Саме тому повідомлення містить власну назву цілі для того, що відхилило ім’я (release name, Service name), і власну причину цілі, а не правило, вбудоване в компілятор.

Чому ім’я відхиляється, а не скорочується. Ім’я, яке ви написали, — це розгорнуте ім’я вашого робочого навантаження: його скорочення перейменувало б кожен ресурс у кожному наявному виводі, і зробило б це від вашого імені, без вашого запиту. Обрати інше ім’я може лише той, хто написав це, тому зупинка вказує на ключ spec.components, який ви написали, і залишає ім’я без змін. Імена, які Aggrega складає сама, — наприклад, ідентичність Feature, приєднаної до цілої межі, — натомість скорочуються, бо їх зібрано з частин, написаних у кількох документах, і жоден окремий автор не бачить, якої довжини вони сягають.

Ціль може дати дві відповіді, і вони ведуть у різні боки. Якщо коротше ім’я було б прийнято, зупинка вказує довжину, яка підійде, тож нове ім’я обирають один раз, а не двічі. Якщо жодна довжина не допоможе — символ, який граматика цілі відхиляє в тій позиції, де він опинився, — довжина не вказується, бо скорочення цього не виправить. Найпоширеніший випадок другого типу: ціль, чиї імена складаються лише з малих літер, екранує кожен символ, якого не допускає, і кожне екранування починається з дефіса, тож ім’я, перший символ якого екрановано, дає ім’я, що починається з дефіса. Ціль, яка вимагає там малу літеру або цифру, відхиляє його, хоч якою короткою була б решта. Ціль також може підпорядковувати початок імені суворішому правилу ресурсів, названих за ним: ціль helm відхиляє ім’я, що починається з цифри, і повідомляє про це як про Service name, бо Helm приймає таке ім’я релізу, тоді як кластер відхиляє Kubernetes Service, названий за ним.

Третя форма з’являється лише для складеного імені: ціль може вказати довжину, меншу за найкоротшу ідентичність, яку компілятор здатен скласти з наданих йому частин, оскільки складена ідентичність резервує місце для дискримінатора. Зупинка повідомляє про це й називає спосіб виправлення — скоротити авторські частини, — а не оголошує провайдера несправним.

Деякі імена існують лише для робочого навантаження, яке рендерить компонент. Провайдера запитують, щойно розв’язано сутність Workload цього компонента, і запит містить form цієї сутності Workload та її ключі Service, тож ціль може оцінити й імена, які вона з них будує. Для цілі helm це додає два: CronJob name — щонайбільше 52 символи, оцінюється лише для сутності Workload форми scheduled, бо кластер називає Job кожного запуску за CronJob із доданим суфіксом; і кожне Service name, <release name>-<service key>, — щонайбільше 63 символи. Ім’я Service будується з частин двох авторів — імені вашого компонента та ключа, який оголошує робоче навантаження в Recipe або FeatureRecipe, — тож його причина називає ключ і місце, де робоче навантаження його оголошує, spec.workload.services.<key>, поруч із полем, яке ви написали. Для ключа, настільки довгого, що не залишає місця для жодного імені компонента, довжина, у межах якої можна обирати, не вказується, а причина каже, що коротшим має бути саме ключ. Ці імена не оцінюються для сутності Feature, приєднаної до цілої межі: її ідентичність встановлюється до розв’язання її сутності Workload, бо від неї може залежати, де збирається її вивід.

Повідомлення, що виводиться, для авторської ідентичності:

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 (ціль не прийме ім’я, похідне від авторської ідентичності цього компонента: перейменуйте компонент (компонент “<identity>”, записаний у <field-path>, який ціль не може використати як <name-kind>, <the target's reason>). оберіть ім’я довжиною не більше <n> символів, яке ціль приймає)

Як виправити: перейменуйте компонент на такий, який приймає ціль, на кожній поверхні, що його називає, — в Aggregate, яка його оголошує, і в Release, яка його розміщує й налаштовує. Якщо повідомлення вказує довжину, не перевищуйте її. Якщо ні, прочитайте причину цілі: зазвичай це символ, якого ціль не допускає, найчастіше велика літера на початку імені — або, для цілі helm, цифра там. Віддавайте перевагу малим літерам і цифрам із дефісами між словами; розділ про іменування пояснює, чого коштує ім’я для кожного виду цілі. Якщо причина називає ключ Service, довжину можна також відвоювати, скоротивши цей ключ там, де його оголошує робоче навантаження, — а якщо причина каже, що ключ не залишає місця, допоможе лише це. Перейменування компонента змінює ім’я, яке мають його ресурси, тож у вже розгорнутому застосунку ставтеся до нього як до будь-якого іншого перейменування ресурсу.

Якщо ідентичність складена компілятором, а не написана вами, та сама зупинка повідомляє складене значення й просить скоротити частини, з яких його побудовано, — ім’я, під яким ви приєднали Feature, і шлях межі, до якої ви її приєднали.

A provider never accepted a name the compiler composed (Провайдер так і не прийняв ім’я, складене компілятором)

Ця зупинка повідомляє про дефект у плагіні, а не в чомусь, що написали ви.

Визначення складеного імені — це обмін: компілятор пропонує ідентичність, провайдер або приймає її, або повідомляє, наскільки короткою вона має бути, компілятор складає коротшу, і провайдера запитують знову. Друга відмова — це нормально й очікувано: скорочення до певної довжини може поставити символ туди, де граматика цілі його не допускає, і повідомлення провайдера про це — спосіб, у який компілятор, що не знає граматики жодної цілі, і провайдер, який її знає, доходять згоди.

Ненормально, коли провайдер ніколи нічого не приймає: вказує довжину, отримує ім’я такої довжини й знову його відхиляє. Обмін обмежено, і після досягнення межі збирання зупиняється й називає провайдера, а не використовує ім’я, на яке провайдер так і не погодився. Ім’я, визначене через відмову від узгодження, було б проставлено на реальних ресурсах, і ніщо у виводі не фіксувало б, що згоди не досягнуто, а наслідки проявилися б під час застосування, а не в збиранні, яке це спричинило.

Повідомлення, що виводиться:

provider guest never accepted a component identity the compiler composed for it (provider guest "<provider>", refused <n> proposals, the last of them "<identity>"). report the defect to whoever maintains that provider plugin (гостьовий провайдер так і не прийняв ідентичність компонента, яку компілятор склав для нього (гостьовий провайдер “<provider>”, відхилено пропозицій: <n>, остання з них “<identity>”). повідомте про дефект тому, хто супроводжує цей плагін провайдера)

Як виправити: повідомте про це тому, хто підтримує названий плагін провайдера, навівши останню пропозицію з повідомлення. Жодна зміна в авторських файлах цього не обійде: компілятор уже запропонував кожну довжину, яку запитував провайдер. Якщо провайдера підтримуєте ви, слід перевірити, що ім’я, обрізане до вказаної ним межі, він потім приймає.

Обов’язковий сокет uses: не заповнено

Component оголошує у своїй usesSchema сокет, позначений required: true, і ніщо в збірці не під’єднує з’єднання до цього сокета для одного з екземплярів цього Component.

Під’єднати його можуть три поверхні, і зупинка спрацьовує лише тоді, коли всі три порожні. Власний блок uses: екземпляра в Aggregate; запис uses: для окремого ребра в Release, що називає target: і цим створює з’єднання в оголошене, але не прив’язане гніздо; і набір з’єднань, створений композицією, який відповідає за компонент, внесений імпортованим Aggregate, — блок uses: такого компонента міститься у власному документі того Aggregate, який читається лише після того, як композицію зібрано. Оскільки третя поверхня стає повною останньою, перевірка виконується, коли вже існує вся композиція, а не під час читання двох написаних автором документів, і вона ставить те саме питання кожному компоненту, незалежно від того, який документ його оголосив.

Дві форми, які начебто мали б заповнювати сокет, цього не роблять. Запис Release без target: налаштовує з’єднання, яке вже має існувати, а не створює нове, тож нічого не під’єднує (а якщо містить infra:, про нього повідомляє власна зупинка вище). А uses: прикріплення Feature називає сокети, оголошені в прикріпленому Feature, — окремий набір сокетів в окремій сутності, тож прикріплення ніколи не може заповнити власний сокет Component.

Повідомлення, що виводиться:

required uses socket not populated (Component, at .spec.components.<instance>.uses.<socket>, "<socket-name>", declared required by component type "<component-type>") (обов’язковий сокет uses не заповнено: сокет у вказаному місці оголошено обов’язковим вказаним типом компонента)

Знахідка позиціонується на записі сокета, який має написати автор: .spec.components.<instance>.uses.<socket>. Ім’я екземпляра в ньому — це ім’я, яке компонент має в документі, що його оголошує, тож для компонента, внесеного імпортованим Aggregate, локатор називає ключ, що міститься у власному файлі цього Aggregate, а не ім’я з префіксом, яке дала йому композиція.

Повідомляється про кожен незаповнений обов’язковий сокет у кожному компоненті: одна збірка повідомляє про всі, а не лише про перший.

Як виправити: додайте запис uses: для обов’язкового сокета, під’єднавши його до цілі, яку приймає selector: сокета; або під’єднайте його з Release записом, що називає target:. Якщо сокет більше не має бути обов’язковим, оновіть usesSchema у Component, задавши required: false, або видаліть оголошення required.

Перевищено глибину вкладення субагрегатів

Ланцюжок імпортів субагрегатів перевищує максимальну глибину вкладення компілятора. Обмеження запобігає неконтрольованому сплощенню глибоко вкладених топологій і змушує до архітектурної декомпозиції понад певний поріг.

Повідомлення, що виводиться:

max sub-aggregate nesting depth exceeded: depth <depth> at prefix <flattened-prefix>. (перевищено максимальну глибину вкладення субагрегатів: глибина <depth> за префіксом <flattened-prefix>.)

Як виправити: перебудуйте топологію агрегатів, щоб зменшити вкладеність. Така глибока вкладеність зазвичай свідчить, що форма Aggregate відображає організаційну ієрархію, а не топологію розгортання, — спробуйте сплощити групи субагрегатів у рівноправні підсистеми в межах одного батьківського Aggregate.

Feature type mismatch between Aggregate and Release (невідповідність типу Feature між Aggregate і Release)

І сутність Aggregate, і сутність Release приєднують feature з однаковою назвою екземпляра, але кожна оголошує інший type:, і приєднання з Release доходить до компонента з features: межі. Якщо ж Release записує його у власному записі для компонента, той самий конфлікт відхиляється раніше й повідомляється як E0153 у розділі «A feature attached by both the Aggregate and the Release cannot be merged (Feature, приєднану і в Aggregate, і в Release, неможливо об’єднати)» вище.

Повідомлення, що виводиться:

feature type mismatch between Aggregate and Release (node <node-id>, attachment <instance-name>, existing type <type-in-aggregate> conflicts with <type-in-release>) (невідповідність типу функції між Aggregate і Release (вузол <node-id>, прикріплення <instance-name>, наявний тип <type-in-aggregate> конфліктує з <type-in-release>))

Як виправити: або приберіть type: із Release (тип буде успадковано з Aggregate), або змініть одну зі сторін так, щоб обидві оголошували той самий тип. Release може пропустити тип або повторити тип з Aggregate, але не може підставити інший, тож за потреби вирівняйте значення type: в обох документах.

Циклічний extends у Components або Features

Ланцюжок extends: сутності Component або ланцюжок extends: сутності Feature замикається сам на себе.

Повідомлення, що виводиться, з Feature замість Component, коли замикається ланцюжок Feature:

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 (циклічний ланцюжок extends: сутність розширює посилання, яке вже є в ланцюжку; вилучіть extends у цієї сутності або спрямуйте його на сутність поза ланцюжком)

Як виправити: відкрийте сутність, яку називає ребро, — у ланцюжку з трьох і більше сутностей це не та сутність, що названа на початку повідомлення, — і видаліть або перенаправте її extends:.

Компонент, який містить композиція, не розміщено в жодній межі

Release розміщує компонент у межі двома способами, і зараховується будь-який із них. Він називає компонент у components межі, адресуючи його за id, який компонент має після сплощення всієї композиції. Або спрямовує модуль, що вносить компонент, у межу через aggregates, що розміщує одразу всі компоненти цього модуля.

Компонент, що не потрапив під жоден зі способів, рендериться поза всіма межами, оголошеними в Release. Його вихідний каталог, його sync wave, його анотації та його покомпонентний infra тоді не беруться нізвідки — а збірка інакше завершилася б успішно, вивела б артефакти й нічого не сказала б про те, що конфігурацію оператора до нього так і не застосовано. Два компоненти, розділені цією лінією, також рендеряться в різні виходи й утрачають порядок, який мають, коли розміщені разом.

Дві форми навмисно не підпадають під це. Release, що оголошує components верхнього рівня замість іменованих меж, розміщує все, що називає: нормалізація такого Release дає йому власну межу, яка містить саме ці компоненти. А про компонент, увесь модуль якого Release ніде не розмістив, натомість повідомляється один раз щодо модуля, у записі нижче, — одна помилка, одне виправлення, один ключ для редагування, — а не по разу для кожного компонента, чиє власне оголошення правильне.

Повідомлення, що виводиться. Значення наприкінці — це id, який компонент має після сплощення композиції; для компонента, внесеного модулем, це ім’я модуля, крапка та власне ім’я компонента:

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>") (компонент не розміщено в жодній межі: назвіть його в components межі або розмістіть підмодуль, що його вносить, в aggregates)

Як виправити: назвіть компонент у components межі, використовуючи саме той id, який наводить повідомлення, — для компонента, внесеного модулем, це id з префіксом, а не ім’я, написане у власному файлі модуля. Або, якщо весь модуль належить до однієї межі, спрямуйте його туди через aggregates, і всі його компоненти буде розміщено одразу.

Компоненти підмодуля не розміщено в жодній межі

Форма правила вище на рівні модуля: модуль, який внесла композиція, додав компоненти, і жодна межа не містить жодного з них. Про це повідомляється один раз для модуля, а не для кожного компонента, бо один модуль, не розміщений ніде, — це одна помилка авторства з одним виправленням в одному ключі, а повідомлення для кожного компонента називало б компоненти, власні оголошення яких цілком правильні.

Правило перевіряє розміщення, а не запис, тому модуль, кожен компонент якого окремо названо в components межі, вважається розміщеним і проходить перевірку: відхиляти його через відсутність запису маршрутизації означало б відкидати форму авторства, яку мова допускає. Модуль, розміщений лише частково, також проходить — які з його компонентів мають власні записи, вирішує правило для компонентів, і про всі пропущені повідомляється там, кожен у власному ключі.

Модуль, який не додав жодного компонента, не спричиняє цієї зупинки: розміщувати нічого. Так само й модуль, вилучений перемикачем active: зі значенням false, який узагалі не було скомпоновано.

Повідомлення, що виводиться, прив’язане до запису aggregates, який оголосив модуль, під локальною назвою, яку написав документ, що імпортує:

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>") (підмодуль не розміщено в жодній межі: спрямуйте його в межу в розділі aggregates або назвіть там його компоненти в розділі components)

Як виправити: додайте запис aggregates для модуля в межі, до якої він належить, — це розмістить усі компоненти, які він додає. Або, якщо його компоненти належать до різних меж, назвіть кожен із них у межі, до якої він належить, використовуючи префіксовані ідентифікатори, які вони мають після сплощення.

Межа називає компонент, якого композиція не містить

Протилежний випадок до двох правил вище — надмірне називання, — і окреме питання, а не гілка жодного з них: ті питають про компонент, чи щось його розмістило, а це питає про запис, який написав Release, чи щось йому відповідає. Жодне не випливає з іншого. Release може назвати неіснуючий компонент, коли кожен наявний компонент розміщено правильно, і може залишити реальний компонент нерозміщеним, коли кожен його запис розв’язується.

Запис, який нічого не називає, нічого не конфігурує: його directory, subDirectory, syncWave, анотації та infra для компонента написано для компонента, якого немає, тож під ними нічого не рендериться, і інакше збірка завершилася б успішно, а конфігурація оператора мовчки не мала б жодного впливу.

Межа називає компонент двома способами, і перевіряються обидва. У components запис адресує компонент за ідентифікатором, який той має після сплощення композиції, — тож компонент, доданий модулем, записується з префіксом цього модуля перед власною назвою. У записі маршрутизації aggregates запис адресує компонент за локальною назвою, яку той має всередині модуля, і вона розв’язується в той самий ідентифікатор. Повідомлення цитує ідентифікатор, який запис адресував, і для маршрутизованого варіанта це не та назва, що написана у файлі: файл містить локальну частину, а решту додає модуль.

Підсистема нічого не додає до ідентифікатора компонента, тому компонент, оголошений у підсистемі, адресується за самою назвою. Запис, написаний так, ніби підсистема є частиною ідентифікатора, нічого не адресує і спричиняє цю зупинку.

Компонент, вимкнений перемикачем active: зі значенням false, не спричиняє цієї зупинки. Вимкнення компонента — це дія автора, і не очікується, що Release, який його конфігурує, буде переписано в тій самій правці: відхилення запису зробило б перемикач непридатним, доки будь-який Release називає цей компонент.

Повідомлення, що виводиться:

boundary names a component the composition does not hold: correct the name, or remove the entry (Release <name>, at <authored key>, "<addressed id>") (межа називає компонент, якого немає в композиції: виправте назву або видаліть запис)

Як виправити: порівняйте ідентифікатор, який цитує повідомлення, з компонентами, які композиція справді містить. Дві поширені причини — пропущений префікс модуля та назва підсистеми, записана в ідентифікатор; приберіть підсистему, додайте префікс модуля або виправте написання. Якщо запис залишився від компонента, який відтоді вилучили або перейменували, видаліть його.

Ребро uses указує на компонент, вилучений перемикачем active:

Споріднена зупинка до зупинки через висячу ціль вище, про яку повідомляється окремо, щоб автор дізнався, чому ціль відсутня. Ціль відсутня не тому, що її ніколи не оголошували, — її оголошено, і її навмисно вилучено з цієї збірки, бо її перемикач active: розв’язався у false, забравши з собою її ребра. Компонент, що залишився, усе ще залежить від неї, і якби ребро просто зникло, впроваджені значення цього споживача мовчки залишилися б порожніми під час розгортання.

Повідомлення, що виводиться. Спочатку йде відмова, потім ціль, яку вилучив перемикач, і сокет, у який було під’єднано з’єднання, — а потім що з цим робити:

uses edge target was pruned because its active toggle resolved to false ("<target>", wired into socket "<socket>"). Keep the target’s active toggle true, or drop the dependency on it. (ціль ребра uses вилучено, оскільки її перемикач active набув значення false. Залиште перемикач active цілі у значенні true або приберіть залежність від неї.)

Знахідку прив’язано до авторського запису, якого вона стосується, за тими самими шляхами, що їх називає зупинка через висячу ціль вище, і повідомляється про кожне хибне з’єднання, а не лише про перше.

Як виправити: вирішіть, що з двох належить до цього середовища. Увімкніть ціль знову — якщо її перемикач читає параметр, це означає надати параметр для цього Release. Або поставте споживача за той самий перемикач, щоб обидва зникали разом і жодне ребро не вказувало в нікуди. Або, якщо споживачеві вона справді більше не потрібна, вилучіть ребро з блоку uses: споживача.

A uses target names a module’s component the module does not export (Ціль uses називає компонент модуля, який модуль не експортує)

Модуль публікує свій інтерфейс у exportedComponents:, а документ, що імпортує модуль, доходить до компонентів модуля лише через ці назви: назву модуля, крапку й один із його псевдонімів. Ціль uses:, що доходить до компонента всередині модуля будь-яким іншим способом — за назвою компонента всередині модуля або шляхом крізь модуль до вкладеного в нього модуля, — зупиняє збирання, бо з’єднання було б прив’язане до того, чого автор модуля не публікував і що він може вільно перейменувати або вилучити. Це однаково стосується власного блоку uses: компонента, блоку приєднання та з’єднання, під’єднаного сутністю Release. Те, у які модулі входить з’єднання, визначається за місцем його споживача, тож з’єднання між двома компонентами одного модуля — зокрема коли Release з’єднує їх між собою — не перетинає жодного інтерфейсу й не відхиляється. Про ціль, якій не відповідає жоден компонент, натомість повідомляє зупинка через завислу ціль, тож одна назва з помилкою повідомляється один раз.

Повідомлення, яке видається. Спочатку йде відмова, потім ціль у записаному вигляді, модуль, до якого вона входить, і псевдоніми, які цей модуль експортує, і сокет — потім те, що з цим робити:

uses edge target names a component its module does not export ("<target>", module "<module>", which exports "<aliases>", wired into socket "<socket>"). Name the component through one of the module’s exported aliases, or list it under the module’s exportedComponents. (ціль ребра uses називає компонент, якого його модуль не експортує (зазначаються ціль, модуль і псевдоніми, які він експортує, а також сокет, до якого під’єднано з’єднання). Назвіть компонент через один із псевдонімів, які експортує модуль, або перелічіть його в exportedComponents модуля.)

Про модуль, який нічого не експортує, кажуть, що він експортує "nothing". Знахідку прив’язано до записаного запису в документі, який провів з’єднання.

Як виправити: назвіть компонент через псевдонім, який експортує модуль, — finance-db-subsystem.primary_db, а не finance-db-subsystem.internal-pg-primary, — або, якщо модуль пишете ви й хочете опублікувати компонент, перелічіть його в exportedComponents модуля під його власною назвою, якщо саме цією назвою мають користуватися ті, хто імпортує.

Перемикач active: не розв’язується в true або false

Перемикач active: надходить до побудовника графа вже розв’язаним у літерал — булеве значення, написане безпосередньо, або посилання на параметр, у яке підставили значення Release перед читанням документа. Далі він читається суворо: літерал, що не є булевим, зупиняє збірку, а не набуває якогось значення за замовчуванням. Правило однакове для перемикача компонента і для перемикача модуля.

Порожній літерал — випадок, який варто назвати окремо, бо саме його дає незаповнений параметр. Перемикач, що читає {{ .parameters.<key> }}, розв’язується в порожнє значення, поки параметр не має значення, і якби порожнє значення читалося як «наявний», розгорталася б та сама сутність, яку автор поставив за параметр. Лише перемикач, якого ніхто не написав, за замовчуванням означає «наявний», і це визначається з відсутності перемикача, а не з його значення, — тому написати active: без нічого після нього не те саме, що пропустити ключ.

Повідомлення, що виводиться:

active toggle did not resolve to a boolean (node "<node>", active resolved to "<value>") (перемикач active не набув булевого значення)

а якщо він розв’язався в порожнє значення, — з порадою, що називає звичайну причину:

active toggle did not resolve to a boolean (node "<node>", active resolved to ""). a toggle reading a parameter resolves to nothing until that parameter is fulfilled (перемикач active не набув булевого значення, active набув значення "". Перемикач, що читає параметр, не має значення, доки цей параметр не задано)

Як виправити: напишіть true або false. Якщо перемикач читає параметр, надайте цей параметр у Release або задайте йому default: там, де його оголошено в Aggregate, щоб кожне середовище мало відповідь. Щоб сутність була наявна безумовно, вилучіть ключ active:, а не залишайте його порожнім.

Модуль, який імпортує композиція, не вдається завантажити, або він імпортує сам себе

Aggregate компонує інші Aggregates, називаючи їх у aggregates:, і кожен по черзі завантажується та обходиться, щоб його компоненти приєдналися до графа. Цей обхід тут зупиняють дві речі.

Модуль узагалі не вдається завантажити — посилання не розв’язується ні в що, що каталог може повернути, або документ за ним не вдається прочитати. Причина, яку надав завантажувач, передається під зупинкою, а не вбудовується в неї, тож те, що не вдалося, описано власними словами завантажувача.

Або модуль називає тип, що вже є в ланцюжку, який обходиться. Його розгортання відтворювало б ланцюжок, що його містить, без кінця. Про це повідомляється в точці, де посилання замикає цикл, із зазначенням і типу, і місця в композиції, де він розташований.

Повідомлення, що виводиться, для циклічного посилання:

sub-aggregate load failed (circular sub-aggregate reference "<module-type>", at "<path in the composition>") (не вдалося завантажити підагрегат (циклічне посилання на підагрегат “<module-type>”, у “<path in the composition>”))

і для помилки завантаження, де зупинка складається лише з речення, прив’язана до шляху модуля, з власною причиною завантажувача під нею:

sub-aggregate load failed (не вдалося завантажити підагрегат)

Як виправити: для помилки завантаження прочитайте причину під зупинкою — найчастіше це назва або версія, на яку каталог не може відповісти, і виправлення вноситься в запис aggregates:, що її називає. Для циклічного посилання розірвіть цикл: шлях у повідомленні — це місце, де ланцюжок замикається, і один із модулів на ньому має перестати імпортувати той, що імпортує його. Якщо двом модулям справді потрібні компоненти один одного, спільна частина має бути в третьому модулі, який імпортують обидва.

Два екземпляри сплощуються в один ідентифікатор

Компонування сутності Aggregate сплощує всі компоненти в єдину множину, і компонент, доданий модулем, має назву цього модуля, крапку та власну назву. Множина не допускає двох записів під одним ідентифікатором: другий замінив би перший, і один із двох компонентів зник би з виводу без жодного повідомлення.

Ця зупинка виникає під час злиття компонентів модуля, і поверхня авторства не пропонує назв, які б її спричинили. Кожен компонент, доданий модулем, має назву цього модуля перед власною; назва екземпляра пишеться з літер, цифр, - і _, тож не може містити крапку, якою їх з’єднано, і два ідентифікатори, побудовані з різних назв модулів, не можуть збігтися. Два модулі, імпортовані під однією назвою, — це один дубльований ключ, і документ відхиляється під час завантаження. Тож це страховка для композиції, зібраної не звичайним шляхом авторства, і про такий випадок варто повідомити, а не обходити його.

Два компоненти однієї сутності Aggregate, що потрапляють в один ідентифікатор, — це інша зупинка, і її спричиняє звичайне написання — див. Two subsystems declare a component under one name (Дві підсистеми оголошують компонент під однією назвою) нижче.

Повідомлення, що виводиться:

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>") (колізія сплощених ID вузлів: перейменуйте один із конфліктних екземплярів, щоб їхні сплощені ID відрізнялися (id “<identifier>”, шлях “<path in the composition>”, конфліктує з наявним записом від “<the other contributor>”))

Як виправити: перейменуйте один із двох екземплярів, названих у повідомленні, у документі, що його оголошує, і в кожному записі Release, що його адресує.

Дві підсистеми оголошують компонент під однією назвою

Підсистеми групують компоненти сутності Aggregate для читача та для того, що на них каскадно поширюється; вони не уточнюють ім’я, за яким звертаються до компонента. До компонента, оголошеного в subsystems.frontend, звертаються як до api, а не як до frontend.api, а компонент, який додав модуль, має ім’я цього модуля, а не підсистеми. Тож дві підсистеми однієї сутності Aggregate можуть кожна оголосити компонент з іменем api, і тоді обидва матимуть той самий ідентифікатор.

Документ правильно сформований — це окремі ключі в окремих блоках, саме тому ніщо раніше його не відхиляє, — але ідентифікатор може мати лише один компонент. Збірка зупиняється, а не зберігає той, що прочитано останнім, і не рендерить так, ніби оголошено один компонент.

Та сама назва двічі в одній підсистемі — інша помилка: це два записи під одним ключем, і документ відхиляється під час читання.

Повідомлення, що виводиться:

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>") (компоненти в різних підсистемах мають однакову ідентичність: перейменуйте один із них, оскільки підсистема нічого не додає до ідентичності компонента)

Як виправити: перейменуйте один із двох компонентів у документі, що його оголошує, і в кожному записі Release, що його адресує. Якщо це справді той самий компонент, потрібний у двох місцях, оголосіть його один раз і залежте від нього з іншої підсистеми. Перейменування підсистеми не допоможе: підсистема не є частиною назви.

Повторно опублікований псевдонім компонента вказує сам на себе

Модуль публікує частину себе, експортуючи компоненти під псевдонімами, а Aggregate, що його імпортує, може повторно опублікувати один із цих псевдонімів під власною назвою. Розв’язання такого псевдоніма проходить ланцюжком повторних публікацій до компонента, який він зрештою називає, щоб ребро, що вказує на публічну назву, досягало реального компонента.

Ланцюжок, що повертається до псевдоніма раніше, ніж досягає компонента, ніколи не завершується. Обхід зупиняється, а не йде ним нескінченно, і називає пройдений ланцюжок, щоб було видно ланку, яка замикає цикл.

Ніщо, що ви можете написати, не створює такого ланцюжка. Дерево імпортів ациклічне, і кожна ланка називає щось вкладене глибше, ніж попередня, тож ланцюжок, зібраний з імпортів, спускається і закінчується. Отже, це страховка для таблиці псевдонімів, зібраної не звичайним шляхом авторства, а не форма, яку може оголосити Aggregate.

Повідомлення, що виводиться:

re-exported component alias forms a cycle (alias chain <first> -> <second> -> <first>) (повторно експортований псевдонім компонента утворює цикл (ланцюжок псевдонімів <first> -> <second> -> <first>))

Як виправити: ніщо у ваших файлах цього не спричиняє, і жодна зміна авторства цього не усуне. Повідомте про це, вказавши виконану команду та ланцюжок псевдонімів із повідомлення — саме він показує, де замкнувся цикл.

An Aggregate reached graph building without being normalised (Сутність Aggregate дійшла до побудови графа без нормалізації)

Сутність Aggregate, написана з компонентами на верхньому рівні, і сутність Aggregate, написана з іменованими підсистемами, під час читання набувають однієї форми: компоненти верхнього рівня згортаються в підсистему, яку надає компілятор, а верхній рівень очищується. Саме це згортання дає змогу всьому подальшому ставити одне питання до однієї форми.

Сутність Aggregate, що надходить до побудови графа з обома заповненими, не була створена цим читанням. Дві форми взаємовиключні там, де їх пишуть, — документ, що оголошує обидві, відхиляється під час завантаження, — а згортання робить їх однією формою потім, тож ніщо, що може написати автор, сюди не доходить. Це страховка для сутності Aggregate, зібраної не звичайним шляхом завантаження, і про такий випадок варто повідомити, а не обходити його.

Його повідомлення починається так:

aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem) (агрегат дійшов до топології ненормалізованим (непорожні кореневі компоненти поряд із синтезованою підсистемою за замовчуванням))

і продовжується шляхом побудови, який очікує компілятор, — це примітка для того, хто налагоджує збірку, а не інструкція для автора.

Як виправити: ніщо у ваших файлах цього не спричиняє, і жодна зміна авторства цього не усуне. Повідомте про це, вказавши виконану команду.

Патч плагіна з роллю label-transform виходить за межі міток вузлів

Плагін керування, підключений у ролі label-transform, отримує проєкцію графа — один запис на вузол, що несе мітки цього вузла та значення, які оголошує його екземпляр, причому кожне значення, яке його Component оголошує чутливим, приховано, — і повертає патчі до міток вузлів. Хост застосовує їх лише до міток, а потім перевіряє, що повернене залишилося тим самим поданням міток: ті самі вузли, кожен лише з мітками, кожне значення мітки — рядок.

Усе інше відхиляється, і збірка зупиняється. Додавання чи вилучення вузла або зміна будь-якого поля вузла, крім міток, — це саме та непомітна поява інфраструктури, яку ніхто не оголошував, тож замість того, щоб поглинути зміну, яку роль не охоплює, збірка повідомляє, яке правило обмеження порушив патч. Мітки — це вся поверхня ролі, і оператор, який підключив плагін, оголосив саме це й не більше.

Повідомлення, що виводяться. Патч відхилено до його застосування:

mutator patch rejected: patch <n> does not decode as a JSON Patch document: <what the reader could not do> (патч мутатора відхилено: патч <n> не декодується як документ JSON Patch: <what the reader could not do>) mutator patch rejected: patch <n> does not apply to the node-label surface: <what the patch engine refused> (патч мутатора відхилено: патч <n> не застосовується до поверхні міток вузлів: <what the patch engine refused>)

або результат його застосування не є тим поданням, яке передав хост:

mutator patch rejected: mutated node set changed size (a mutator may not add or remove nodes) (патч мутатора відхилено: змінений набір вузлів змінив розмір (мутатор не може додавати чи видаляти вузли)) mutator patch rejected: mutated node set introduced node "<node>" (a mutator may not add nodes) (патч мутатора відхилено: змінений набір вузлів додав вузол <node> (мутатор не може додавати вузли)) mutator patch rejected: node "<node>" gained a field outside "labels" (a mutator may only touch labels) (патч мутатора відхилено: вузол <node> отримав поле поза “labels” (мутатор може змінювати лише мітки)) mutator patch rejected: node "<node>" lost its "labels" field (патч мутатора відхилено: вузол <node> втратив поле “labels”) mutator patch rejected: node "<node>" carries a non-string label value after patching: <what the reader found> (патч мутатора відхилено: після застосування патча вузол <node> містить нерядкове значення мітки: <what the reader found>)

Як виправити: помилка в плагіні, а не у ваших документах. Виправте його так, щоб кожна операція, яку він повертає, адресувала запис у labels певного вузла й встановлювала лише рядкові значення — найчастіше трапляється числове чи булеве значення мітки, оскільки поверхня приймає лише рядки. Вилучення підключення з plugins.governance — це негайний спосіб розблокувати збірку, поки плагін виправляють.

Навмисний пропуск: топологія не мусить бути ациклічною

Aggrega дозволяє цикли в топології: вона не вимагає, щоб граф залежностей був орієнтованим ациклічним графом. Архітектури «агент — агент», шаблони зворотних викликів і пари взаємної автентифікації створюють циклічні ребра, і компілятор їх приймає. Порядок під час розгортання — справа рендерера (через syncWave для кожної межі або еквівалент), а не графа IR.

Під час перевірки контрактів inject

Компілятор обходить кожен блок inject: — як self-inject (сутність Component, що впроваджує значення в саму себе), так і uses-inject (cross-Component-зв’язування) — і перевіряє контракт доставки щодо схеми provides: цільової сутності Component, розбиття міток сутності Feature та набору оголошених ключів доставки. Ключ from: у блоці, який написав власний компонент сутності Aggregate, перевіряється одразу після розв’язання каталогу, тож помилка вказує на рядок, який ви написали; такий ключ у блоці компонента, який додає модуль, перевіряється, щойно зібрано композицію, що імпортує модуль, і помилка вказує на рядок у власному документі модуля; ключ from: у з’єднанні, яке додає приєднана сутність Feature, перевіряється, щойно свій внесок зробили всі поверхні, що можуть створювати з’єднання, — це найраніший момент, коли таке з’єднання вже існує й його можна перевірити.

Inject from key is not in the target’s provides (Ключ from в inject відсутній у provides цілі)

Запис inject: посилається на ключ from:, якого не публікує джерело, з якого він читає: схема provides: цільової сутності Component — для власного блоку компонента або з’єднання, і сутність FeatureRecipe приєднаної сутності Feature — для власного блоку inject: приєднаної сутності Feature.

Перевірка застосовується незалежно від того, де написано з’єднання. З’єднання uses: потрапляє до побудованої топології з кількох поверхонь написання — із власного блоку uses: сутності Component і з блоку uses: приєднаної до неї сутності Feature, незалежно від того, чи це приєднання написано на компоненті, на підсистемі, на межі сутності Release або на записі компонента в межі сутності Release, — і той самий ключ із помилкою відхиляється на кожній із них. Діагностика вказує на блок, автор якого його написав: на власний запис uses: приєднання, у місці, де оголошено саме приєднання, а не на блок uses: компонента-споживача, який для доданого з’єднання взагалі нічого не містить.

Те, щодо чого розв’язується посилання, залежить від того, де воно розміщене. Self-inject from: на рівні сутності Component розв’язується щодо власного provides: тієї самої сутності Component. from: у з’єднанні uses: розв’язується щодо provides: компонента, на який вказує це з’єднання, — а якщо дві поверхні пишуть один сокет і один псевдонім, кожне з’єднання розв’язується щодо цілі, яку називає саме воно, у тій самій збірці, що відхиляє цю пару через спільний псевдонім. Сутність Component, яка не оголошує provides:, відхиляє кожне посилання from:, спрямоване на неї.

Власний блок inject: приєднаної сутності Feature. Тамтешній from: розв’язується відносно ключів, які сутність FeatureRecipe цієї сутності Feature публікує у своєму provides:, у тому вигляді, в якому їх обчислено для компонента, до якого приєднано сутність Feature, і перевіряється, коли цей компонент рендериться. Ключ, якого сутність FeatureRecipe не публікує, не помістив би нічого в середовище, файл або аргумент компонента, тож натомість збірка зупиняється — якщо тільки сутність FeatureRecipe сама не читає записи приєднаної сутності Feature, у .inject, у шаблоні, який вона обчислює відносно власного контексту рендерингу приєднаної сутності Feature — того, що містить .inject: тобто в її зіставленні значень, робочому навантаженні, артефактах, пропусках або в with: чи when: кроку конвеєра, написаних безпосередньо чи імпортованих. Її locals:, provides:, source: і assertions: не містять .inject, а її injectMapping: обчислюється відносно контексту компонента, тож читання в будь-якому з них не враховується. Така сутність FeatureRecipe отримує кожен запис у написаному вигляді й доставляє його по-своєму, тож її записи не відхиляються, а ключ, якого вона не публікує, нічого не доставляє через власну доставку компонента й залишається в розпорядженні сутності FeatureRecipe. Чи читає сутність FeatureRecipe .inject, визначається за шляхами, які називають її шаблони: шаблон, що передає далі весь свій контекст (toJson .) або дістається до записів через функцію на зразок index . "inject", не вважається таким, що їх читає, і її записи, що називають неопублікований ключ, відхиляються. Сутність Feature, приєднана на межі, чия сутність FeatureRecipe рендериться один раз для цієї межі, перевіряється відносно цього одного обчислення; там, де жодна межа, що містить компонент, такого обчислення не створила, немає відносно чого перевіряти її ключі, і вони не відхиляються. from:, що називає опублікований ключ, доставляє як і раніше. Знахідку розміщено на власному записі приєднаної сутності Feature, у документі, який його написав, — наприклад, .spec.components.<component>.features.<attachment> у сутності Aggregate, — а запис, ключ доставки якого вже також утримує інше джерело inject, повідомляється також у розділі «An attachment delivers a key another inject source already claimed (Приєднання доставляє ключ, який уже зайняло інше джерело inject)», оскільки кожен потребує власного виправлення.

У власному блоці inject: компонента запис value: містить літерал і ні щодо чого не розв’язується, тож літерал, який випадково схожий на ключ provides, там не відхиляється; на з’єднанні запис value: відхиляється, як описано нижче в розділі «An inject: entry on a connection carries a literal (Запис inject на з’єднанні містить літерал)». Ключ називає лише from:.

Власна поверхня uses: сутності Release для кожного ребра містить target і infra та не містить inject:, тож з’єднання, зв’язане там, не визначає доставки й не має ключа from: для перевірки.

Повідомлення, що виводиться, для ключа from: у власному блоці inject: сутності Component. Спершу йде відмова, потім помилковий ключ, тип компонента, щодо якого його розв’язували, і оголошені ключі цього типу в упорядкованому вигляді — варіанти, з яких можна вибрати:

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>") (недійсний ключ inject: from-key має називати ключ provides, який публікує його джерело)

Для ключа from: у з’єднанні uses: спочатку йде та сама відмова, а механізм і ключ доставки, під якими написано запис, стоять перед помилковим ключем:

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>") (недійсний ключ inject: from-key має називати ключ provides, який публікує його джерело)

Для from:, прочитаного у власному блоці inject: приєднаної сутності Feature, першим іде помилковий ключ, потім in: і механізм запису, сутність FeatureRecipe, відносно якої його розв’язано, і кожен ключ, який публікує ця сутність FeatureRecipe, у відсортованому порядку:

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>") (недійсний ключ inject: from-key має називати ключ provides, який публікує його джерело)

Якщо ціль узагалі не оголошує ключів provides:, варіантів для переліку немає, тож повідомлення закінчується після типу компонента — або, у блоці приєднаної сутності Feature, після сутності FeatureRecipe.

Як виправити: або змініть ключ from: на один з оголошених ключів, перелічених у повідомленні, або розширте схему provides: цільової сутності Component, оголосивши потрібний ключ. У блоці приєднаної сутності Feature змініть ключ from: на той, який публікує сутність FeatureRecipe, або — якщо сутність FeatureRecipe ваша — опублікуйте ключ у її provides:, або зробіть так, щоб вона сама читала запис у .inject, якщо доставляє значення по-своєму.

Required feature not attached (Обов’язкову функцію не приєднано)

Сутність Component оголошує вимогу присутності — анотацію features.aggrega.ai/requiredType.<label>, — що називає тип сутності Feature, якого немає серед приєднань, з якими зрештою опиняється цей екземпляр компонента, з урахуванням усіх областей: блоків рівня компонента й рівня підсистеми сутності Aggregate, блоків рівня межі й рівня компонента сутності Release та розгортання на основі анотацій.

Повідомлення, що виводиться:

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>) (відсутня обов’язкова функція: приєднайте до компонента Feature обов’язкового типу (<required-type>, вимагається типом компонента <component-type>, під міткою вимоги <label>))

Три значення — це тип сутності Feature, якого вимагає вимога (речення вище вже його називає, тож він стоїть без підпису), потім тип компонента, що оголошує вимогу, і мітка, яку несе вимога, кожне з підписом, щоб читач міг розрізнити два посилання на сутності. Компонент, що вимагає двох різних типів, повідомляє два різні повідомлення, а двом компонентам, які оголошують вимогу з різних типів, повідомляється, який тип висунув кожну вимогу. Звіт розташовується на власному ключі компонента в components:, а для компонента, написаного всередині підсистеми, — спершу під ключем цієї підсистеми.

Ім’я, під яким написано приєднання, тут не має значення: вимога лише перевіряє, чи присутнє приєднання названого типу. Її задовольняє прив’язка слота, а також приєднання під будь-яким іншим ім’ям.

Як виправити: приєднайте сутність Feature обов’язкового типу до компонента в сутності Aggregate чи Release або в ширшій області, яку компонент успадковує. Якщо сутність Component більше не повинна цього вимагати, вилучіть анотацію вимоги з її оголошення в каталозі.

Malformed attachment requirement (Некоректна вимога до приєднання)

Оголошення вимоги присутності неможливо обчислити. Значення анотації — непрозорий рядок, тож ніщо не перевіряє його форму до того, як компілятор його прочитає: значення, яке не є URI типу сутності Feature, або ключ, що називає сімейство вимог без мітки після префікса, повідомляється як зламане оголошення, а не як незадоволена вимога, — одруківка ніколи не повинна виглядати як задоволена вимога.

Повідомлення, що виводяться:

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. (некоректна вимога до приєднання (<key>, оголошена типом компонента <component-type>, яку неможливо обчислити, бо значення має бути URI типу Feature вигляду publisher/name із сегментів kebab у нижньому регістрі, як-от core/prometheus-exporter). Виправте цю анотацію на сутності каталогу типу компонента.)

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. (некоректна вимога до приєднання (key, оголошена типом компонента component-type, яку неможливо обчислити, бо ключу потрібна мітка, що називає вимогу, як-от features.aggrega.ai/requiredType.database). Виправте цю анотацію на сутності каталогу типу компонента.)

Повідомлення починається з ключа анотації — оголошення, якого стосується зупинка, — і після нього називає тип компонента, чиє оголошення зламане, тож воно називає сутність, яку слід виправити, хоча звіт розташовано на екземплярі компонента, що використовує цей тип: екземпляр — це місце, де ви бачите проблему, а сутність каталогу — місце, де її виправляють.

Ця зупинка виникає одразу після складання композиції, тобто раніше за будь-яку перевірку, що читає готовий граф. Тому збірка зі зламаною вимогою повідомляє лише про неї: перевірки, які виконувалися б пізніше, не досягаються, бо вони міркують про те, що каже оголошення, а оголошення неможливо прочитати. Виправте його й перезберіть, щоб побачити решту.

Як виправити: виправте сутність каталогу Component. Виправлення робиться в каталозі, а не в сутності Aggregate, — саме тому ця зупинка відрізняється від «Required feature not attached (Обов’язкову функцію не приєднано)», де змінювати слід ваші власні документи.

Required attachment slot not bound (Обов’язковий слот підключення не заповнено)

Сутність каталогу оголошує слот підключення з required: true у своєму featuresSchema, і жодне підключення не заповнює слот із цим ім’ям на екземплярі сутності. Перевірка виконується щодо підключень, які екземпляр має після згортання всіх областей — блоків features: рівня компонента й рівня підсистеми в Aggregate, блоків рівня межі й рівня компонента в Release, а також підключень, створених розгортанням на основі анотацій, — тож облікові дані, підключені один раз в області, від якої екземпляр успадковує, заповнюють слот так само, як заповнення, написане на самому екземплярі.

Повідомлення, що виводиться:

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>, оголошений обов’язковим типом компонента <component-type>). Підключіть Feature під цим ім’ям в Aggregate або в Release, на компоненті чи в області над ним.)

Два значення — це власне ім’я слота й тип компонента, що його оголошує, тож один екземпляр, який залишає два слоти незв’язаними, повідомляє два різні повідомлення. Звіт розміщується на ключі слота в блоці features: компонента в сутності Aggregate; оскільки саме цього ключа й бракує, редактор ставить його на найближчий наявний ключ — на блок features:, де компонент його пише, і на сам компонент, де не пише. Відсутнє приєднання ніхто не написав, тож воно не вказує на автора жодного документа: звіт залишається на компоненті й реєструється як помилка розробника, а виправлення називає обидва документи, бо слот може заповнити будь-який із них — Aggregate на компоненті чи підсистемі, що його містить, або Release у своєму записі для компонента чи на межі, що його містить.

Слот, який оголошує сокет, — у featuresSchema запису usesSchema — є обов’язковим для кожного з’єднання, проведеного через сокет, а не для компонента: кожне з’єднання заповнює його саме, у власному записі в Aggregate або в Release, і жодна вища область до нього не дістає. Тож сокет із двома з’єднаннями, одне з яких заповнює слот, повідомляє лише про інше, називаючи його:

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>, оголошений обов’язковим сокетом <socket> типу компонента <component-type>, не заповнений з’єднанням <alias>). Приєднайте Feature під цим слотом у features цього з’єднання, у його записі в Aggregate або в Release.)

Цей звіт прив’язано до запису з’єднання в документі, що провів з’єднання, — запису uses: в Aggregate або запису для окремого ребра в Release для з’єднання, яке провів Release. З’єднання, яке проводить підключена Feature, веде до сокета, оголошеного цією Feature, а не компонентом, тож заповнювати слоти сокетів компонента не його справа.

Як виправити: підключіть Feature під ім’ям слота в Aggregate або в Release — на компоненті або в ширшій області, спільній для всіх споживачів слота; для слота сокета — на з’єднанні, яке називає звіт. Підключення під іншим ім’ям слот не заповнює: слот — це іменована точка прив’язки, тож прив’язкою є саме ім’я. Якщо слот більше не має бути обов’язковим, оновіть featuresSchema сутності каталогу — власний для компонента або сокета, — щоб прибрати оголошення required.

Two Features declared to conflict reach one component (Дві Features, оголошені конфліктними, досягають одного компонента)

interoperability.conflictsWith у Feature називає Features, разом з якими її не можна підключати, і один компонент у підсумку несе цю Feature й одну з названих. Перевірка виконується щодо підключень, які компонент має після згортання всіх областей — блоків features: рівня компонента й рівня підсистеми в Aggregate, блоків рівня межі в Release (кожної межі, всередині якої розташований компонент, зокрема вкладених) і записів рівня компонента, а також підключень, створених розгортанням на основі анотацій. Тож пара зупиняє збирання, коли обидві написано на компоненті, коли одна розташована на межі чи підсистемі, що його містить, або коли одна на зовнішній межі, а інша на вкладеній у неї межі. Дві Features, підключені до сусідніх меж без спільного компонента, ніколи не зустрічаються, а межа без компонентів нічого не досягає, тож жодна з цих ситуацій не зупиняє збирання.

Достатньо одного оголошення: зупинка спрацьовує, коли список будь-якої з Features називає іншу. Імена порівнюються без версії з обох боків, тож запис відповідає кожній версії Feature, яку він називає. Компілятор порівнює імена, оголошені автором Feature, з Features, які несе компонент, і нічого більше в них не вкладає.

Повідомлення, що виводиться:

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. (Feature досягає компонента разом із Feature, з яким вона оголошує конфлікт (<feature>, приєднана в Release на межі <boundary-path>, конфліктує з <other-feature>, приєднаною в Aggregate на компоненті <component>, на компоненті <component>). Приєднайте лише одну з двох там, де вони зустрічаються: вилучіть одне приєднання або перенесіть його в область, що не містить цього компонента.)

Перше значення — це Feature, список якої називає іншу, — та, яку називає речення вище, — і за нею йдуть усі місця, де її приєднано; потім Feature, з якою вона конфліктує, і всі місця, де приєднано ту; і насамкінець компонент, де вони зустрічаються. Кожне місце записано словами документа, який ви відкрили б, щоб його змінити: attached in the Aggregate on component, attached in the Aggregate on subsystem, attached in the Release on boundary (шлях вкладеної межі з’єднує її рівні через /), attached in the Release on the entry for component, після чого in boundary, або attached by annotation-driven expansion of з анотацією, після чого declared at із місцем, де її написано. Приєднання, написане на з’єднанні, записується як запис цього з’єднання, оскільки саме цей запис, а не власний блок компонента, є місцем, де його редагують: attached in the Aggregate on the connection, після чого through socket і of component, або attached in the Release on the connection, після чого through socket, of the entry for component і in boundary. Feature, приєднана у двох місцях, перелічує обидва. Звіт розміщується на власному ключі компонента в components:, а пара, що зустрічається на кількох компонентах, повідомляється один раз для кожного з них у порядку, в якому Aggregate оголошує компоненти.

Як виправити: підключіть лише одну з двох там, де вони зустрічаються, — видаліть одне з підключень або перенесіть одне в область, що не містить цього компонента, наприклад на сусідню межу. Якщо підключення походить із розгортання на основі анотацій, змінювати слід анотацію, а не блок, у який її розгорнуто. Якщо ці дві Features насправді можна поєднувати, помилкою є оголошення: видаліть іншу Feature зі списку conflictsWith у сутності каталогу Feature, що його оголошує.

Attachment does not conform to its declared slot shape (Прикріплення не відповідає оголошеній формі слота)

Прикріплення зв’язує оголошений слот, але не відповідає формі, яку цей слот оголошує. Типовий випадок — доставка: список дозволених механізмів inject слота називає механізми, через які заповнення може доставляти свій матеріал, а порожній список дозволених означає «чорну скриньку» — Recipe доставляє матеріал внутрішньо, і заповнення не може диктувати жодної доставки. Порожній блок inject: {} не диктує доставки, тож відповідає формі кожного слота, зокрема й слота з порожнім списком дозволених, і отримує однаковий вердикт, хоч би де було записано прикріплення: на компоненті, який оголошує Aggregate, на компоненті, який вносить імпортований модуль, чи в ширшій області. Прикріплення під ім’ям, якого не оголошує жоден слот, є вільним прикріпленням і не має обмежень слота.

Повідомлення, яке видається, коли приєднання диктує доставку, якої не приймає його слот, — спочатку слот, потім механізм, а потім кожен механізм, який приймає список дозволених inject слота, у порядку, в якому слот їх оголошує (для порожнього списку дозволених далі нічого не йде):

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<slot>", "<mechanism>", "<permitted-mechanism>") (приєднання не відповідає оголошеній формі свого слота)

Компонент, який вносить імпортований модуль, перевіряється після побудови композиції, що його імпортує, і повідомляється в другій формі. Вона називає Aggregate модуля та ключ у документі модуля, якого слот не оголошує, — механізм у блоці inject: приєднання або сам блок inject:, коли він називає будь-який механізм у слоті з порожнім списком дозволених:

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>) (прикріплення не відповідає оголошеній формі слота: цей ключ не входить до оголошення слота)

де <remedy> залежить від ключа:

  • remove it, для блоку inject:, що називає механізм у слоті з порожнім списком дозволених;
  • remove it, or add it to the slot's inject allowlist in the entity's featuresSchema, для механізму, який може назвати список дозволених слота, — env, file або arg;
  • remove it: a slot's inject allowlist in the entity's featuresSchema accepts only env, file and arg, для будь-якого іншого механізму, якого не може оголосити жоден слот.

Прикріплення, оголошене в ширшій області — на всю підсистему, з каскадним поширенням на кожен компонент під нею, — має відповідати тій самій формі, і його перевіряють щодо слота на кожному компоненті, якого воно досягає. Тож те саме прикріплення може відповідати формі для одного компонента й не відповідати для іншого, тому ця форма повідомлення називає компонент і слот, перевірку якого не пройдено, і вказує на прикріплення в області, де його оголошено, а не на ключ усередині його блоку доставки:

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) (прикріплення не відповідає оголошеній формі слота: це прикріплення оголошено в області, що охоплює компонент, слот прикріплення якого не приймає доставку, яку воно несе: перенесіть прикріплення нижче, до компонентів, які можуть його отримати)

Прикріплення, яке несе з’єднання, ніколи не призводить до цієї зупинки. Його форма закрита там, де його написано: у записі з’єднання в сутності Aggregate воно приймає type, description і values, а в сутності Release — type, description і infra, тож воно взагалі не може диктувати доставку — написаний там inject: відхиляється під час завантаження документа із зазначенням ключа, — а запис Workload, що його доставляє, натомість перевіряється за списком дозволених inject слота сокета. Жодна область також не охоплює слот сокета, тож наведена вище форма для області не має відповідника для з’єднання.

Як виправити: ці форми вимагають двох різних змін, і шлях поля підкаже, яка з них у вас. Якщо він називає прикріплення на компоненті або ключ усередині нього, помилка в доставці: видаліть її або перенесіть її записи під механізм, який називає список дозволених inject слота. Якщо матеріал справді має досягати робочого навантаження через механізм, якого слот не перелічує, список дозволених у featuresSchema сутності каталогу можна розширити — але лише механізмами env, file або arg, які може оголосити слот; Component, що називає там будь-який інший механізм, не проходить перевірку під час завантаження, тож для будь-якого іншого механізму єдине виправлення — видалити його. Якщо він називає прикріплення в області, прикріплення сформоване правильно, а помилка в його розміщенні: перенесіть його нижче, на компоненти, чий слот приймає доставку, залишивши поза його досяжністю компоненти, які резервують доставку за своїм Recipe.

Duplicate delivery key across inject sources (Дублікат ключа доставки серед джерел inject)

Той самий ключ доставки (наприклад, та сама назва змінної середовища) заявлено двічі серед джерел inject, написаних розробником для одного компонента: на рівні сутності Component і в записі uses[], у двох записах uses[] того самого компонента або під двома механізмами доставки власного блоку inject: сутності Component. Доставка не може надходити з двох місць одночасно, тому ключ, заявлений двічі, — це суперечність, а не питання того, який із них переможе.

Збірка перевіряє це у чотирьох місцях, бо вони бачать різні набори написаних джерел і з’єднань залежностей і ставлять до них різні запитання, і кожне повідомляє у власній формі.

Перше читає з’єднання, які ви написали в сутності Aggregate, і повідомляє під час розв’язання ваших файлів. Воно називає механізм доставки, ключ, а потім сокет і псевдонім першого в порядку написання з’єднання, яке також заявляє цей ключ:

duplicate delivery key across inject sources (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<socket>", "<alias>") (дубльований ключ доставки серед джерел inject)

Друге читає той самий написаний блок і ставить до нього інше запитання: чи заявляє компонент один ключ під двома власними механізмами доставки, без жодного з’єднання. Воно повідомляє один раз для кожного механізму, що заявляє ключ, з позицією у власному записі цього механізму, і називає механізм, якого стосується повідомлення, ключ, а потім кожен інший механізм, що його заявляє, у порядку написання:

duplicate delivery key across inject sources (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<other-mechanism>") (дубльований ключ доставки серед джерел inject)

Жоден із механізмів не є порушником, і обидва повідомлення стосуються того, що змінювати вам: перейменуйте ключ під одним із них або приберіть одну з двох доставок. Які механізми компонент взагалі може використовувати — окреме питання, на яке відповідає його список дозволених spec.inject, — див. «Self-inject mechanism not in the component’s allowlist (Механізм self-inject відсутній у списку дозволених компонента)» нижче.

Компонент, який додає модуль, теж підпадає під ці дві перші форми, що зчитуються з власного документа модуля, щойно зібрано композицію, яка його імпортує; тоді вони називають сутність Aggregate модуля та ключ у її документі.

Третє читає з’єднання, які містить готова топологія, включно з тими, що додало від вашого імені приєднання Feature. Воно виконується до будь-якого рендерингу і називає написаний вами ключ доставки разом із сокетом залежності, який також його доставляє:

duplicate delivery key across self-inject and uses-inject ("<key>", socket "<socket>") (дубльований ключ доставки між self-inject і uses-inject)

Один написаний ключ, доставлений через два сокети залежностей, повідомляється один раз для кожного сокета, тож одна збірка повідомляє вам про всі, а не лише про той, до якого дійшла першим.

Четверте читає ту саму готову топологію і ставить до неї інше запитання: чи доставляють два власні з’єднання залежностей компонента один ключ між собою, тоді як сам компонент нічого не заявляє. Воно повідомляє один раз для кожного з’єднання, з позицією у власному записі доставки цього з’єднання, і називає шлях запису, а за ним кожен сокет, що доставляє ключ:

duplicate delivery key across inject sources ("inject.<mechanism>.<key>", "<socket>", "<socket>") (дубльований ключ доставки серед джерел inject)

Сокет, названий двічі, означає, що два з’єднання розташовані на одному сокеті під різними псевдонімами — тоді їх розрізняє лише позиція, тож читайте шлях поля кожного з двох повідомлень, а не назви сокетів.

Жодне з’єднання не є порушником, і змінювати обидва вам: перейменуйте один із ключів або приберіть одну з двох доставок.

Якщо ключ є шляхом, шлях поля натомість називає блок механізму. Що саме записує ключ доставки — справа самого механізму, а механізм file доставляє в шлях монтування, — тож такий ключ містить крапки, тоді як шлях поля розділяє ними власні кроки. Шлях поля зупиняється на останньому кроці, який можна назвати однозначно, а не записує крок, що читався б як прохід ключами, яких ваш документ не містить, тож для ключа на кшталт /etc/app/config.yaml він має вигляд .spec.components.<component>.inject.<mechanism> і на цьому зупиняється. Повідомлення в будь-якому разі називає ключ, і саме це зберігає його однаково придатним для дій, — але те, де в повідомленні його читати, різниться в чотирьох формах вище, тож читайте шлях поля для блоку, а ключ беріть із тієї з чотирьох форм, яка у вас є: якщо деталі починаються з механізму доставки, ключ — це значення в лапках одразу після нього; якщо деталі починаються із самого ключа, це перше значення в лапках; а якщо деталі починаються із власного шляху запису доставки, ключ — останній крок цього шляху.

Як виправити: перейменуйте один із конфліктних ключів або вилучіть дубльоване оголошення. Зауважте, що перезаписування в injectMapping сутності FeatureRecipe ключа, який доставив власний блок inject: компонента або один із блоків inject: його з’єднань, є навмисним перехопленням і не позначається ні тут, ні деінде.

Ключ, заявлений сутністю Feature, приєднаною до компонента, потрапляє в той самий спільний простір із третьої з трьох поверхонь написання і повідомляється в розділі «An attachment delivers a key another inject source already claimed (Приєднання доставляє ключ, який уже заявило інше джерело inject)» нижче; ключ, який доставляють дві приєднані Features, коли пізніша з двох доставляє його через injectMapping своєї сутності FeatureRecipe, повідомляється в розділі «Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Дві приєднані Features доставляють один ключ, пізніша — через injectMapping своєї FeatureRecipe)».

Self-inject on a component without an allowlist (Self-inject у компоненті без списку дозволених)

Розробник написав блок inject: на рівні компонента, але сутність каталогу Component не оголошує spec.inject. Components без списку дозволених spec.inject є типами Black-Box — вони не отримують ін’єкцій, написаних розробником.

Повідомлення, що виводиться:

self-inject on component without spec.inject allowlist (Aggregate <name>, at .spec.components.<component>.inject, "inject", "<component-type>") (self-inject у компоненті без списку дозволених spec.inject)

Повідомлення має позицію в самому блоці inject:, який і слід видалити.

Як виправити: видаліть блок inject: із цього екземпляра Component або перейдіть на тип Component White-Box, оголошення якого в каталозі містить spec.inject.

Self-inject mechanism not in the component’s allowlist (Механізм self-inject відсутній у списку дозволених компонента)

Розробник написав блок inject: на рівні компонента з механізмом (наприклад, env або певною формою монтування файлу), якого немає у списку дозволених spec.inject сутності Component.

Повідомлення, що виводиться:

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 у компоненті без списку дозволених spec.inject)

Механізми, які тип дозволяє, йдуть після продиктованого, тож повідомлення містить і те, що написано, і те, що дозволяє тип. Тип, що взагалі не оголошує списку дозволених, повідомляє продиктований механізм без нічого після нього.

І це правило, і наведене вище діють для компонента, який додає модуль, щойно зібрано композицію, що імпортує модуль; тоді звіт називає сутність Aggregate модуля та ключ у її документі.

Як виправити: перейдіть на дозволений механізм або, якщо Component має підтримувати потрібний вам механізм, розширте його список дозволених spec.inject у каталозі.

uses edge dictates delivery on a socket that allowlists none (ребро uses нав’язує доставку через сокет, що не має списку дозволених механізмів)

Блок inject: на ребрі uses: під’єднується до сокета, чий запис usesSchema не оголошує списку дозволених inject: або оголошує порожній. Такий сокет є з’єднанням типу Black-Box: сутність, що його оголосила, обробляє значення залежності всередині, тож споживач отримує те, що видає Recipe постачальника, і не обирає форму доставки. Відсутній ключ inject: і inject: [] — це те саме оголошення.

Сокет зчитується з тієї сутності, яка його оголосила: ребро, записане на прикріпленні Feature, розв’язується щодо usesSchema прикріпленої сутності Feature, а будь-яке інше ребро — щодо схеми сутності Component, яка споживає залежність.

Повідомлення, що виводиться. Спочатку йде відмова, потім механізми, які нав’язало ребро, сокет і сутність, чиє оголошення було зчитано, — а потім те, що з цим робити:

uses-edge inject dictates a delivery mechanism the socket does not permit ("<mechanism>", on socket "<socket>", declared on the component type "<component-type>"). The socket declares no delivery allowlist, so it permits no dictation at all — the entity that declared it delivers the dependency’s values itself. Remove the inject block from this connection and read the values from the connection’s provides in the consuming Recipe, or declare the mechanisms the socket permits in its usesSchema entry. (ін’єкція на ребрі uses диктує механізм доставки, який сокет не дозволяє (“<mechanism>”, на сокеті “<socket>”, оголошено на типі компонента “<component-type>”). Сокет не оголошує списку дозволених механізмів доставки, тож не дозволяє жодного диктування — сутність, що його оголосила, сама доставляє значення залежності. Видаліть блок inject із цього з’єднання й читайте значення з provides з’єднання у Recipe споживача або оголосіть механізми, які дозволяє сокет, у його записі usesSchema.)

Знахідка прив’язана до записаного елемента, якого вона стосується, у документі, де цей елемент записано: .spec.components.<consumer>.uses.<socket>.<alias> для ребра, проведеного власним блоком uses: компонента, і .spec.components.<consumer>.features.<attachment>.uses.<socket>.<alias> для ребра, проведеного прикріпленням, — з коренем у блоці, що оголосив прикріплення, яким може бути блок підсистеми чи межі, а не самого компонента. Якщо сокет оголошено на прикріпленій сутності Feature, повідомлення називає тип функції замість типу компонента. Кожне порушне ребро повідомляється окремою знахідкою, тож одна збірка називає їх усі.

Як виправити: видаліть блок inject: із ребра й натомість читайте значення залежності з .context.uses.<alias>.provides.<name> у Recipe споживача; або, якщо з’єднання має бути прозорим, оголосіть механізми доставки, які дозволяє сокет, у списку дозволених inject: його запису usesSchema.

Сокет, якого сутність-оголошувач узагалі не оголошувала, — це інший випадок, і тут він не відхиляється: ситуативний сокет не має списку дозволених механізмів, тож ребру нема за що виходити.

uses edge dictates a delivery mechanism outside the socket’s allowlist (ребро uses нав’язує механізм доставки поза списком дозволених механізмів сокета)

Блок inject: на ребрі uses: називає механізм доставки, якого немає у списку дозволених inject: сокета. Список дозволених — це заява сутності, що оголошує сокет, про те, з яких форм доставки її точка входу справді може прочитати значення залежності, тож механізм поза ним доставив би значення, які ніщо не використовує.

Перевіряється кожен механізм, який називає блок, і повідомляється про кожен поза списком дозволених, тож одна збірка називає їх усі, а не по одному за запуск.

Повідомлення, що виводиться. Спочатку йде відмова, потім відхилений механізм, сокет, те, що цей сокет дозволяє, і сутність, чиє оголошення було зчитано:

uses-edge inject dictates a delivery mechanism the socket does not permit ("<mechanism>", on socket "<socket>", which permits "<mechanism-1>, <mechanism-2>", declared on the component type "<component-type>"). Dictate one of the mechanisms the socket permits, or widen that socket’s inject allowlist in the declaring entity’s usesSchema entry. (ін’єкція на ребрі uses диктує механізм доставки, який сокет не дозволяє (“<mechanism>”, на сокеті “<socket>”, який дозволяє “<mechanism-1>, <mechanism-2>”, оголошено на типі компонента “<component-type>”). Продиктуйте один із механізмів, які дозволяє сокет, або розширте список дозволених inject цього сокета в записі usesSchema сутності, що його оголошує.)

Знахідка прив’язана до записаного елемента, якого вона стосується, за тими самими шляхами, що називає відмова вище. Якщо сокет оголошено на прикріпленій сутності Feature, повідомлення називає тип функції замість типу компонента.

Як виправити: перейдіть на один із дозволених механізмів або, якщо сутність має підтримувати потрібний вам механізм, розширте список дозволених механізмів inject: цього сокета в його записі usesSchema у каталозі.

An inject: entry carries both a literal and a source key (запис inject містить і літерал, і ключ джерела)

Запис inject: доставляє одне з двох: літерал, записаний під value:, — у власному блоці компонента, єдиному місці, де доставляється літерал, — або ключ, зчитаний із компонента, на який вказує з’єднання, записаний під from:. Запис, що містить обидва, каже дві речі одночасно й не дає правила вибору між ними, тому він відхиляється, а не дозволяє одному з двох тихо перемогти.

Схеми авторингу допускають рівно один елемент пари, тож документ, зчитаний із файлу, відхиляється під час завантаження. Ця перевірка стоїть позаду тієї: вона читає кожен блок inject:, який містять сутності Aggregate і Release, поки ці два документи розв’язуються, тож документ, побудований іншим шляхом, ніж із файлу, усе одно відхиляється до того, як із нього щось буде побудовано, а не отримує мовчки вибране одне поле. Вона охоплює ті самі блоки, що й перевірка форми нижче.

Кожен механізм доставки, що містить порушний запис, повідомляється як окрема знахідка, прив’язана до цього механізму в документі, який його записав, — .spec.components.<component>.inject.env для власного блоку компонента, — і про всі такі знахідки у збірці повідомляється одразу. Знахідка називає механізм, а потім in: кожного порушного запису в списку цього механізму.

Повідомлення, що виводиться:

inject entry carries both value: and from:; schema requires exactly one ("<mechanism>", "<in-1>", "<in-2>") (запис inject містить і літерал, і ключ-джерело; схема вимагає рівно одного)

Як виправити: відкрийте кожен запис, який називає повідомлення, і видаліть той із двох елементів, який йому не потрібен. Залиште from:, якщо значення має надходити з компонента, на який вказує з’єднання, — він називає ключ, який оголошує provides: цього компонента. Залиште value:, якщо значення — це літерал, який надає ця сторона у власному блоці компонента; на з’єднанні та у власному блоці приєднаної сутності Feature літерал відхиляється, тож там залиште from:.

An inject: entry on a connection carries a literal (Запис ін’єкції на з’єднанні містить літерал)

З’єднання доставляє в споживчий компонент те, що публікує компонент, на який воно вказує: кожен запис у блоці inject: з’єднання називає під from: один із ключів provides: цього компонента. Літерал, записаний під value:, не називає нічого з того, що публікує ціль, тож йому немає місця на з’єднанні, і запис відхиляється, а не відкидається. Літерал, який компонент доставляє сам собі, належить до власного блоку inject: компонента, де value: допускається.

Перевіряється кожне з’єднання, хоч би який документ його провів: з’єднання у власному блоці uses: компонента, з’єднання, яке проводить прикріплена сутність Feature в сутності Aggregate, і з’єднання, яке проводить прикріплення, записане в сутності Release. Воно відхиляється до будь-якого рендерингу, тож про нього повідомляє як aggrega validate --release, так і aggrega build.

Кожен порушний запис повідомляється як окрема знахідка, прив’язана до запису з’єднання в документі, який його провів, — .spec.components.<component>.uses.<socket>.<alias> для власного з’єднання компонента, .spec.components.<component>.features.<attachment>.uses.<socket>.<alias> для з’єднання, яке проводить прикріплення, а в сутності Release — той самий шлях під записом прикріплення, наприклад .spec.boundaries.<boundary>.components.<component>.features.<attachment>.uses.<socket>.<alias>, — і про всі такі знахідки у збірці повідомляється одразу. Знахідка в сутності Aggregate належить до DEVELOPER_ERROR, у сутності Release — до OPS_ERROR. Знахідка називає механізм і in: запису.

Повідомлення, що виводиться:

inject entry on a connection carries value:; a connection delivers the target’s published keys, each named with from: ("<mechanism>", "<in>") (запис inject на з’єднанні містить літерал; з’єднання доставляє опубліковані ключі цілі, кожен із яких названо ключем-джерелом)

Як виправити: якщо значення публікує ціль, замініть value: на from:, що називає цей ключ provides:. Якщо це літерал, потрібний споживчому компоненту, перенесіть запис у власний блок inject: цього компонента, механізми якого визначає дозволений список spec.inject його типу Component.

An inject: entry on an attached Feature carries a literal (Запис ін’єкції на приєднаній сутності Feature містить літерал)

Блок inject:, написаний на приєднаній сутності Feature, доставляє в компонент те, що публікує сутність FeatureRecipe цього приєднання: кожен запис називає один із ключів, які публікує provides: сутності FeatureRecipe, під from:. Літерал, написаний під value:, не називає нічого, що публікує приєднання, тож під in: цього запису до компонента нічого не дійшло б; запис відхиляється, а не збирається й відкидається. Літерал, потрібний компоненту, належить до власного блоку inject: компонента, де value: допускається й доставляється.

Перевіряється кожне приєднання, на якому сутність Aggregate пише блок inject:: як у власному блоці features: компонента, так і в блоці features: підсистеми, що охоплює кожен компонент, який містить підсистема, — у сутності Aggregate, яку називає сутність Release, і в кожному модулі, який ця сутність Aggregate імпортує під aggregates:, на будь-якій глибині. З’єднання, яке проводить приєднання, має власний блок inject:, і літерал у ньому підпадає під описане вище відхилення для з’єднань. Приєднання в сутності Release не пише власного блоку inject:. Запис відхиляється до того, як щось буде відрендерено, тож aggrega validate --release повідомляє про нього так само, як aggrega build.

Кожен помилковий запис повідомляється як окрема знахідка, зареєстрована як DEVELOPER_ERROR щодо сутності Aggregate, документ якої написав блок, — власного документа модуля для приєднання, написаного в модулі, — і розміщена на механізмі доставки всередині блоку приєднання в цьому документі: .spec.components.<component>.features.<attachment>.inject.<mechanism> або .spec.subsystems.<subsystem>.features.<attachment>.inject.<mechanism> для приєднання підсистеми. Усі записи в документі повідомляються одночасно; записи в імпортованому модулі повідомляються, щойно імпортувальна сутність Aggregate пройде перевірку. Знахідка називає механізм і in: запису. Запис, що містить і value:, і from:, повідомляється лише один раз, у розділі «An inject: entry carries both a literal and a source key (Запис ін’єкції містить і літерал, і ключ джерела)» вище.

Повідомлення, що виводиться:

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>") (запис inject на приєднанні містить літерал; приєднання доставляє ключі, які публікує його сутність FeatureRecipe, кожен названий як ключ джерела, а літерал належить до власного блоку inject компонента)

Як виправити: якщо значення є одним із тих, які публікує сутність FeatureRecipe приєднання, замініть value: на from:, що називає цей ключ provides:. Якщо це літерал, потрібний компоненту, перенесіть запис до власного блоку inject: компонента, механізми якого визначає список дозволених spec.inject його типу Component:

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 (Доставка ін’єкції не є списком записів)

Кожен механізм доставки в блоці inject: — env, file, arg або механізм, названий поряд із ними, — це список записів, кожен із яких містить in: і рівно одне з from: або value:. Механізм, що містить щось інше, наприклад відображення імен на ключі, не доставляє нічого, що може прочитати компілятор, тож він відхиляється, а не відкидається. Механізм, записаний зовсім без значення, нічого не доставляє і не відхиляється.

Схеми авторингу допускають лише список, тож документ, зчитаний із файлу, відхиляється під час завантаження як документ, що не відповідає схемі свого виду. Ця перевірка стоїть позаду тієї: вона читає кожен блок inject:, який містять сутності Aggregate і Release, поки ці два документи розв’язуються, тож документ, побудований іншим шляхом, ніж із файлу, усе одно відхиляється до того, як із нього щось буде побудовано, а не втрачає доставку. Вона охоплює кожен блок будь-якого з документів: у сутності Aggregate — власний блок компонента, блок прикріплення та блоки на з’єднаннях, які проводить будь-який із них; у сутності Release — блоки на з’єднаннях, які проводять її прикріплення.

Кожен порушний механізм повідомляється як окрема знахідка, прив’язана до цього механізму в документі, який його записав, і така, що називає механізм, і про всі такі знахідки у збірці повідомляється одразу. Знахідки сутності Aggregate повідомляються раніше за знахідки сутності Release.

Повідомлення, що виводиться:

inject delivery: shape must be a list of entries, each in: with exactly one of from: or value: ("<mechanism>") (доставка inject: форма має бути списком записів, кожен із місцем доставки та рівно одним із ключа-джерела або літерала)

Позиція — це шлях ключів, який записав автор. У сутності Aggregate: .spec.components.<component>.inject.<mechanism> для власного блоку компонента, .spec.components.<component>.uses.<socket>.<alias>.inject.<mechanism> для блоку на одному з його з’єднань і .spec.components.<component>.features.<attachment>… для блоку прикріплення, з .subsystems.<name> для кожної підсистеми, у якій оголошено компонент або прикріплення. У сутності Release — блок на з’єднанні, яке проводить прикріплення, через це прикріплення: .spec.boundaries.<boundary>.features.<attachment>.uses.<socket>.<alias>.inject.<mechanism> для прикріплення на всю межу, .spec.boundaries.<boundary>.components.<component>.features.<attachment>… для прикріплення до компонента, з .boundaries.<name> для кожної вкладеної межі та .aggregates.<module> для кожного запису маршрутизації, через який названо компонент.

Як виправити: запишіть кожен механізм, який називає повідомлення, як список. Запис DB_URL: host під env: стає - in: DB_URL із from: host, коли host називає ключ provides: — під’єднаного компонента на з’єднанні, самого компонента в його власному блоці, — або, у власному блоці компонента, із value: host, коли це літерал, який надає ця сторона.

The Feature filling an attachment slot does not satisfy the slot’s selector (Feature, що заповнює слот приєднання, не задовольняє селектор слота)

Сутність Component оголошує іменовані точки прив’язки для Features, на які вона очікує, і слот може оголосити selector:, що обмежує мітки того, чим його заповнюють. Приєднання прив’язує слот, коли має ім’я цього слота; у такому разі мітки Feature, яку воно називає, зіставляються з цим обмеженням, і заповнення, що його не задовольняє, зупиняє збірку. Слот, який не оголошує обмеження, приймає будь-яке заповнення.

Чи можна взагалі залишити слот неприв’язаним — це інше питання з іншим способом виправлення, про яке повідомляє окрема зупинка вище: ця зупинка передбачає наявність заповнення й перевіряє, чи воно допустиме, тож неприв’язаний слот її не стосується.

За цією однією умовою повідомляється про два результати, і повідомлення розрізняє їх за тим, що каже його останнє значення. Заповнення, яке не задовольнило обмеження, називає Feature, чиї мітки не збіглися. Обмеження, яке взагалі не вдалося прочитати, натомість називає причину — вираз, який засіб зіставлення міток не зміг обчислити, — і це помилка в оголошенні самого слота, а не в тому, що до нього приєднано.

Повідомлення, що виводиться, коли мітки заповнення не задовольнили обмеження:

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>, не задоволений мітками Feature, що заповнює його, <feature-type>). Додайте мітки, яких вимагає селектор слота, до міток Feature або заповніть слот іншою Feature, яка вже має ці мітки.)

і коли саме обмеження не вдалося обчислити:

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>, який не вдалося обчислити: <why it could not be evaluated>). Виправте селектор в оголошенні слота в сутності каталогу компонента.)

Знахідка розташовується на ключі заповнення в документі, який записав заповнення, і відноситься до автора цього документа: блок features: компонента в Aggregate — це помилка розробника, а заповнення, яке робить лише Release — у своєму записі для компонента або на межі, що його містить, — це помилка оператора, про яку повідомляється за власним шляхом Release:

[OPS_ERROR E0008] release.yaml at .spec.boundaries.main.components.app.features.identity
attachment slot selector unsatisfied ("feature.aggrega.ai/kind!=secret", declared on slot "identity", not satisfied by the labels of the Feature filling it, "core/secret-value"). Add the labels the slot's selector requires to the Feature's labels, or fill the slot with a Feature that already carries them.

Те саме заповнення, записане на компоненті в Aggregate, повідомляє [DEVELOPER_ERROR E0008] aggregate.yaml at .spec.components.app.features.identity.

Слот, який оголошує сокет — у featuresSchema запису usesSchema, — так само перевіряє заповнення кожного з’єднання на відповідність своєму selector:. Приєднання, яке з’єднання має в слоті, зіставляється з обмеженням, і заповнення, яке воно не допускає, зупиняє збірку, а повідомлення називає сокет і з’єднання, а також слот:

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> сокета <socket>, заповненому на з’єднанні <alias>, не задоволений мітками Feature, що заповнює його, <feature-type>). Додайте мітки, яких вимагає селектор слота, до міток Feature або заповніть слот іншою Feature, яка вже має ці мітки.)

Знахідка розташовується на ключі приєднання в features: цього з’єднання, у документі, який записав заповнення: у записі з’єднання в Aggregate або в записі Release для окремого ребра, якщо заповнення робить лише Release.

Селектор слота, який граматика не може прочитати, теж відхиляється ще до того, як щось заповнить слот. aggrega validate — над усім каталогом або над однією сутністю Component чи Feature — читає кожен селектор слота, який оголошує власний документ сутності, — власні слоти Component, слоти, які оголошують її сокети, і слоти Feature, — і відхиляє той, який граматика не може прочитати, за цією самою умовою незалежно від того, чи щось заповнює слот. Повідомлення має наведену вище форму «не вдалося обчислити»; слот, який оголошує сокет, додає сокет:

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. (селектор слота прикріплення не задоволено: селектор, оголошений у слоті сокета, не вдалося обчислити. Виправте селектор в оголошенні слота у featuresSchema сокета в сутності каталогу компонента.)

Для слота сутності Feature спосіб виправлення натомість називає сутність каталогу цієї Feature. Слот ще ніщо не заповнило, тож помилка — у сутності каталогу: вона класифікується як CATALOG_ERROR і називає файл сутності.

Як виправити: для заповнення, яке не задовольнило обмеження, приєднайте Feature, чиї мітки його задовольняють, — селектор у повідомленні вказує, яких міток вимагають, — або розширте selector: слота в сутності Component, що його оголошує. Якщо повідомлення каже, що обмеження не вдалося обчислити, помилка у виразі селектора: виправте його в оголошенні слота сутності Component або в оголошенні сокета.

An attachment written under another name fits a slot its component leaves empty (Приєднання, записане під іншим ім’ям, підходить до слота, який його компонент залишає порожнім)

Власна поверхня приєднань сутності Component відкрита: приєднання під ім’ям, якого не оголошує жоден слот, — це вільне приєднання, і воно допустиме. Одна форма на цій поверхні зупиняє збірку, бо саме такої форми набуває заповнення, призначене для слота, коли його записано під неправильним ім’ям. Збірка зупиняється, коли для одного приєднання виконуються всі ці умови:

  • його записано на самому компоненті — у власному блоці features: компонента в Aggregate або в записі Release для цього одного компонента;
  • його ім’я не є слотом, який оголошує тип компонента;
  • мітки його Feature задовольняють selector: слота, який оголошує тип;
  • ніщо не прив’язує цей слот на компоненті після згортання всіх областей.

Якщо нічого не робити, таке приєднання буде вільним, а слот, для якого воно призначалося, залишиться порожнім — а необов’язковий порожній слот збирається успішно й нічого не доставляє. Це правило діє для кожної Feature, а не лише для облікових даних.

Усе інше на поверхні залишається вільним. Приєднання, чия Feature не підходить до жодного оголошеного слота, збирається; так само й додаткове приєднання поруч зі слотом, який уже щось прив’язує, якщо жоден інший слот, до якого воно підходить, не залишено порожнім. Приєднання, яке компонент успадковує від підсистеми або межі Release, ніколи не оцінюється, тож спільна форма — одні облікові дані, приєднані один раз в області, де розташовано кілька компонентів, і жоден компонент не заповнює слот, — збирається. Слот, який не оголошує selector:, нічого не каже про те, для якої Feature він призначений, тож жодне приєднання не перевіряється щодо нього в такий спосіб. Приєднання, яке має з’єднання, тут також не оцінюється: слоти сокета — закрита множина, і будь-яке інше ім’я на з’єднанні зупиняє збірку за умовою «A connection carries an attachment under a name its socket declares no slot for (З’єднання має приєднання під ім’ям, для якого його сокет не оголошує слота)».

Повідомлення, що виводиться. Спершу йде речення умови, потім ім’я, під яким записано приєднання, компонент, Feature, яку воно приєднує, і порожній слот, до якого воно підходить, — а потім що з цим робити:

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. (прикріплення, записане під назвою, якої не оголошує жоден слот, підходить до слота, який його компонент залишає порожнім (<attachment>, на компоненті <component>, прикріплює Feature <feature-type>, що підходить до порожнього слота <slot>). Прикріпіть його як <slot>, щоб заповнити слот.)

Якщо Feature підходить до кількох порожніх слотів, повідомлення називає кожен у порядку, в якому їх оголошує тип компонента, і залишає вибір за вами:

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. (прикріплення, записане під назвою, якої не оголошує жоден слот, підходить до слота, який його компонент залишає порожнім (<attachment>, на компоненті <component>, прикріплює Feature <feature-type>, що підходить до порожнього слота <slot> і до порожнього слота <another-slot>). Прикріпіть його під назвою слота, який воно має заповнити.)

Знахідка розташовується на ключі приєднання в документі, який його записав, і відноситься до автора цього документа. Про приєднання у власному блоці features: компонента в Aggregate повідомляється за шляхом .spec.components.<component>.features.<attachment> як про помилку розробника; про приєднання, яке записав лише Release у своєму записі для компонента, повідомляється там — під межею, що називає компонент, .spec.boundaries.<boundary>.components.<component>.features.<attachment>, — як про помилку оператора:

[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.

Сам порожній слот, якщо він обов’язковий, є окремою знахідкою, про яку повідомляється на компоненті в Aggregate за умовою «Required attachment slot not bound (Обов’язковий слот приєднання не прив’язано)».

Чим це відрізняється від попередження про майже збіг. Попередження за умовою «An attachment name is one edit from a declared slot (Ім’я приєднання відрізняється від оголошеного слота одним редагуванням)» стосується написання імені: ім’я на одне редагування від слота, чий selector: Feature приєднання не задовольняє; така збірка проходить і виводить попередження. Ця зупинка стосується того, до чого підходить Feature, незалежно від імені: ім’я може бути будь-яким, а слот, до якого вона підходить, має бути порожнім. Якщо ім’я на одне редагування від слота і його Feature до цього слота підходить, попередження не виводиться, а якщо слот залишено порожнім, єдиною знахідкою буде ця зупинка.

Як виправити: приєднайте його під ім’ям слота, щоб воно заповнило слот, — повідомлення називає слот або всіх кандидатів, якщо їх кілька. Якщо це справді окреме приєднання, заповніть також слот, адже додаткове приєднання вільне, щойно прив’язано кожен слот, до якого воно підходить; або, якщо воно має охоплювати кілька компонентів, приєднайте його на рівні підсистеми або межі Release, де вони розташовані. Якщо Feature ніколи не повинна заповнювати цей слот, звузьте selector: слота в сутності Component, що його оголошує.

An attachment delivers a key another inject source already claimed (Прикріплення доставляє ключ, який уже заявило інше джерело inject)

Три поверхні авторингу доставляють значення в канал ін’єкції одного компонента через блок inject:: власний блок inject: компонента, блоки inject: на записах його блоку залежностей і блок на кожній прикріпленій до нього сутності Feature. Вони спільно використовують один простір ключів для кожного механізму доставки, тож ключ, на який претендують дві з них, робить неоднозначним, яке значення надійде, і збирання зупиняється, щоб одна поверхня мовчки не витіснила іншу. Прикріплена сутність Feature може доставляти й другим способом — через injectMapping свого FeatureRecipe; цей шлях потрапляє в той самий простір після того, як доставили всі блоки, і про нього повідомляється нижче в розділі «Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Дві прикріплені сутності Features доставляють один ключ, пізніша — через injectMapping свого FeatureRecipe)».

Ця умова — бік блоку прикріплення в цьому просторі. Про неї повідомляється, коли власний блок inject: прикріплення заявляє ключ, який уже утримує якась попередня доставка; запис вище в розділі «Duplicate delivery key across inject sources (Дубльований ключ доставки в різних джерелах inject)» — те саме правило, прочитане з боку розробника, і разом вони охоплюють заяву кожного блоку.

Хто спричинив колізію, вирішує порядок. Ключ утримує перша заява під ним, а повідомляється про пізніші заяви — тож прикріплення, чий ключ зайнято, дізнається про це, а прикріплення, яке заявило першим, не дізнається про пізніше, яке нічого не витіснило. Заява, що взагалі нічого не доставила, залишає ключ вільним і в цьому не бере участі.

Знахідка прив’язана до власного запису прикріплення всередині блоку компонента — саме це місце слід редагувати; повідомлення називає ключ і механізм, у просторі ключів якого він перебуває. Про кожен конфліктний ключ повідомляється окремо, тож прикріплення, що дублює два ключі, повідомить вам про обидва.

Повідомлення, що виводиться:

duplicate delivery key across attachment-inject and another inject source ("<key>", mechanism "<mechanism>") (дубльований ключ доставки між attachment-inject та іншим джерелом inject)

Як виправити: жодна зі сторін не є порушником, і обидві ви можете змінити. Перейменуйте ключ на тій стороні, яку контролюєте, — найчастіше це власний запис inject: компонента, оскільки відображення сутності Feature записане в документі каталогу, — або приберіть одну з двох доставок. Якщо прикріплення справді має надавати значення, видаліть претензію, написану розробником, а не претензію прикріплення. Зверніть увагу, що запис ключа через injectMapping з FeatureRecipe сутності Feature — це інший шлях, і тут про нього не повідомляється: перезапис ключа, який доставив власний блок inject: компонента або одне з його з’єднань, є перехопленням і не повідомляється взагалі, а запис ключа, який доставила інша прикріплена сутність Feature, повідомляється в наступному розділі.

Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Дві прикріплені сутності Features доставляють один ключ, пізніша — через injectMapping своєї FeatureRecipe)

Прикріплена сутність Feature доставляє в канал впровадження свого компонента двома шляхами: блоком inject:, записаним на прикріпленні, і injectMapping своєї сутності FeatureRecipe, вихід якого називає ключ доставки — часто на основі значення, яке несе прикріплення, наприклад вибраної для облікових даних змінної середовища. Коли дві прикріплені сутності Features потрапляють до одного ключа за одним механізмом доставки і пізніша з них потрапляє туди через своє відображення, збірка зупиняється. Якби збірка тривала, компонент прочитав би те значення, яке випадково записано останнім, тож одні облікові дані могли б бути подані замість інших, і ніщо у виводі про це б не свідчило.

Це стосується кожної прикріпленої сутності Feature, хоч би де її прикріпили: у власному блоці features: компонента, у підсистемі, на межі Release чи в записі компонента, у розгортанні анотації та в записі features: з’єднання. Ранішою з двох доставок може бути відображення іншої сутності Feature або її власний блок inject: — збирання повідомляє про обидва поєднання під цією однією умовою.

Хто спричинив колізію, вирішує порядок. Кожен блок inject: доставляє до рендерингу будь-якого відображення, а відображення рендеряться в одному фіксованому порядку — у порядку, в якому впровадження через відображення обходить прикріплені сутності Features компонента, описаному в конвеєрі компіляції, — тож ключ утримує перша доставка під ним, а повідомляється про пізнішу сутність Feature. Вирішує лише наявність: значення не порівнюються, тож про дві сутності Features, що доставляють однакове значення під одним ключем, однаково повідомляється. Ключ, якого вихід відображення взагалі не містить, доставкою не є; ключ із порожнім значенням — є, бо порожнє значення замінює те, що там було. Один ключ за двома різними механізмами доставки — це два ключі, а не колізія.

Про що не повідомляється. Перезапис через injectMapping з FeatureRecipe ключа, який доставив власний блок inject: компонента або один із блоків inject: його з’єднань, є перехопленням — маршрутизувальна сутність Feature уточнює хост, захисник перенаправляє upstream, — і значення відображення замінює цей один запис. Перезапис відображенням сутності Feature ключа, який доставив її власний блок inject:, означає, що ця Feature перетворює власну доставку, і про нього також не повідомляється.

Знахідка прив’язана до власного запису пізнішої сутності Feature — усередині блоку features: компонента або, для сутності Feature, яку несе з’єднання, до її запису під цим з’єднанням у документі, що її записав, наприклад .spec.components.<component>.uses.<socket>.<alias>.features.<slot> у сутності Aggregate. Повідомлення називає ключ, механізм доставки та обидві сутності Features за іменами, під якими вони прикріплені до компонента; сутність Feature, яку несе з’єднання, називається псевдонімом з’єднання і слотом, який вона заповнює, з’єднаними крапкою. Про кожен конфліктний ключ повідомляється окремо.

Повідомлення, що виводиться:

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. (дубльований ключ доставлення у двох прикріпленнях: сутність FeatureRecipe одного прикріплення записує ключ доставлення, який інше прикріплення вже доставило. Дайте одному з двох прикріплень власний ключ або прикріпіть на одне прикріплення менше: ключ, під яким доставляє це прикріплення, обирає його сутність FeatureRecipe, яка може читати власні values та infra прикріплення, а ключ іншого обирається так само або його власним блоком inject, якщо воно доставляло через такий блок. Сутність Release задає infra прикріплення і ніколи — його values, тож якщо ключ обирається значенням, прикріпіть це прикріплення в сутності Aggregate разом зі значенням, а решту й далі задавайте із сутності Release.)

Як виправити: дайте одній із двох сутностей Features власний ключ — для сутності Feature з обліковими даними це зазвичай ключ, який називають її значення, — або видаліть одне з двох прикріплень. Якщо обидві мають надавати одну змінну, вирішіть, яку з них має читати компонент, і прикріпіть лише її. Два набори облікових даних, які сутність Release прикріплює самостійно, обидва надходять під ключем, який їхня сутність Feature називає за замовчуванням, бо сутність Release не може записати values прикріплення: прикріпіть один із них у сутності Aggregate зі значенням, що називає його ключ, і вкажіть його джерело із сутності Release у тому самому записі.

Компонент оголошує механізм inject, на який приєднана Feature нічого не відображає

Список дозволених spec.inject сутності Component може називати механізми доставки поза стандартними — механізм, який розуміє власна обв’язка компонента і для якого все, що доставляє в нього, має створити значення. Коли Feature приєднано до такого компонента, саме injectMapping сутності FeatureRecipe визначає, за яким механізмом доставляється кожне створене нею значення. Механізм, який компонент оголосив, а відображення не створює для нього ключа, — це доставка, яка непомітно ніколи не відбулася б, тож збірка натомість зупиняється.

Відображення, яке нічого не каже про механізми, — не те саме, що відображення, яке не називає жодного. FeatureRecipe, чиє відображення рендериться як плаский словник доставок, не робить жодних тверджень про механізми — це звичайний запис для Feature, що створює доставки через змінні середовища, — і так само не робить їх приєднання, яке прив’язує FeatureRecipe без відображення для обчислення. Про жодне з них тут не повідомляється; ця умова стосується лише відображення, яке називає механізми й пропускає один з оголошених компонентом.

Кожен невідображений механізм — окрема знахідка, тож компонент, що оголошує два механізми, жодного з яких приєднання не відображає, повідомить вам про обидва. Знахідка позиціонується на записі приєднання у вашому власному файлі й також називає FeatureRecipe — бо це документ, у якому записано відображення, і він розташований зовсім в іншому місці.

Повідомлення, що виводиться:

custom inject mechanism has no matching key in injectMapping output; add the mechanism’s key to the Recipe injectMapping ("<mechanism>", recipe "<featurerecipe>") (власний механізм inject не має відповідного ключа у виводі injectMapping; додайте ключ механізму до injectMapping сутності Recipe ("<mechanism>", recipe "<featurerecipe>"))

Як виправити: повідомлення називає обидві половини. Додайте ключ механізму до injectMapping сутності FeatureRecipe, щоб Feature створювала для нього значення, або вилучіть механізм зі списку дозволених spec.inject сутності Component, якщо ніщо не має доставляти за ним. Якщо FeatureRecipe належить до чужого каталогу, третя відповідь — приєднати Feature, чиє відображення охоплює цей механізм.

An attached Feature’s injectMapping output cannot be read (Не вдається прочитати вивід injectMapping приєднаної сутності Feature)

injectMapping сутності FeatureRecipe — це шаблон, а те, що він створює, читається як YAML: словник із ключами за механізмом доставки — env, file, arg або власний механізм компонента — чи плаский словник доставок у середовище. Коли вивід не читається ні як одне, ні як інше, жоден із його ключів не можна доставити, тож збірка зупиняється, а не рендерить компонент так, ніби приєднана сутність Feature нічого не доставила. Найважливіший випадок — облікові дані: компонент, що очікує пароль, якого так і не отримав, інакше міг би працювати без нього, і ніщо у виводі про це не повідомило б.

Звичайна причина — значення, яке шаблон записав у лапках як є. Подвійна лапка всередині нього передчасно завершує скаляр у лапках, а зворотна похила риска починає екранування, якого YAML може не знати, тож зіставлення, яке правильно рендериться для більшості значень, ламається на тому, що містить такий символ, — часто на паролі. Вивід, який порожній або розбирається як словник, що нічого не доставляє, — це не ця умова: він нічого не доставляє, і саме це він і повідомляє.

Фрейм над повідомленням називає компонент, що рендериться, потім приєднання — за назвою, яку воно має на компоненті, — і сутність FeatureRecipe, у якій записано зіставлення, у вигляді feature "<attachment>" (recipe "<featurerecipe>") injectMapping output. Під повідомленням указано причину, з якої вивід не вдалося прочитати, — рядок і те, що YAML там знайшов, наприклад yaml: line 2: found unknown escape character. Коли шаблон читає значення, яке автор оголосив чутливим, і причина залежить від того, що це значення містить, причину приховано, а на її місці стоїть речення, яке про це повідомляє, тож зупинка ніколи не цитує значення, що зламало вивід. Збірка повідомляє про зупинку з тегом CATALOG_ERROR, бо зіставлення пише автор сутності FeatureRecipe.

Повідомлення, що виводиться:

FeatureRecipe injectMapping output could not be read as a dictionary of deliveries (Вивід injectMapping сутності FeatureRecipe не вдалося прочитати як словник доставок)

Як виправити: у injectMapping сутності FeatureRecipe записуйте кожне значення через toJson — {{ .values.key }}: {{ .values.origin | toJson }}, — що записує його як рядок JSON, який YAML зчитує назад точно, хоч які символи він містить. Коли сутність FeatureRecipe належить до чужого каталогу, значення також можна змінити так, щоб воно не містило подвійних лапок чи зворотної похилої риски, доки зіставлення не виправлено.

An attached Feature’s injectMapping output writes deliveries under a key nothing delivers (Вивід injectMapping приєднаної сутності Feature записує доставки під ключем, за яким нічого не доставляється)

Вивід injectMapping сутності FeatureRecipe зливається з каналом ін’єкції компонента за ключами верхнього рівня. env, file і arg доставляються як відповідні механізми, а будь-який інший ключ доставляється як окремий механізм під цією назвою, який сутність Recipe компонента читає за шляхом .context.inject.<name>. Подання all інше: воно будується з механізмів після злиття й ніколи не зливається з виводу, тож значення, які зіставлення записує під all:, нікуди не доходять. Вивід при цьому читається без помилок, тож без цієї зупинки збірка, яка читає ці значення як необов’язкові, завершується успішно без них — записані там облікові дані так і не доходять до компонента, і ніщо в збірці не називає зіставлення, яке їх загубило.

Умова діє скрізь, де all: містить принаймні один запис, окремо чи поруч з іншими механізмами; інші механізми в тому самому виводі проблемою не є, а all:, записаний порожнім, нічого не втрачає, і про нього не повідомляється. Плаский словник, у якому випадково є ключ із назвою all з одним значенням, — це доставка в середовище з назвою all, а не ця умова.

Знахідку прив’язано до запису приєднання у вашому власному файлі, і вона називає ключ і сутність FeatureRecipe, у якій записано зіставлення, — бо саме цей документ треба змінити, а він розташований зовсім деінде, — разом із ключами, які може містити вивід. Кожен такий ключ — окрема знахідка. Збірка повідомляє про неї з тегом CATALOG_ERROR.

Повідомлення, що виводиться:

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") (Вивід injectMapping сутності FeatureRecipe записує ключ, якого не читає жоден механізм доставки хоста)

Як виправити: у injectMapping сутності FeatureRecipe перенесіть записи з-під all: до механізму, з якого їх читає компонент, — зазвичай env: або механізм із назвою, яку читає сутність Recipe компонента. Коли сутність FeatureRecipe належить до чужого каталогу, натомість приєднайте сутність Feature, зіставлення якої доставляє це значення.

Під час рендерингу виводу

Після валідації кожного контракту компілятор обчислює шаблони Go у значеннях Component, блоках injectMapping сутностей FeatureRecipe, а також у джерелах Recipe і FeatureRecipe, після чого передає результат рендереру.

Шаблон provides: посилається на несамодостатній корінь

Шаблон provides: сутності Recipe посилається на корінь поза самодостатнім набором. Блок provides обчислюється на етапі обчислення provides, до наповнення каналу inject і до обходу міжвузлових ребер, тому він може посилатися лише на дані власного вузла: .context.instance_id, .context.rendered_name, якщо провайдер вузла його повідомляє, .values, .infra, розв’язані .locals вузла та статичні рядки. Перевірка є позитивним списком дозволеного, тож будь-який інший корінь зупиняє збірку — .context.inject і .context.uses (міжвузлові), .context.annotations.*, .context.labels, .context.metadata і .metadata.* (дані, пов’язані з розміщенням або розгортанням, яких поверхня provides не надає), а також .attachment_name (прохід provides базової сутності Recipe не розв’язує жодного приєднання). Посилання на будь-який із них явно зупиняє збірку, а не мовчки рендерить порожнє значення.

.locals входить до поверхні: locals вузла розв’язуються в преамбулі того самого етапу, перед його provides, тому шаблон provides читає їх і отримує розв’язані значення.

Повідомлення, що виводиться:

provides block references a root outside the self-contained set ("<expression>")

Зупинку прив’язано до сутності Recipe, що оголошує запис, і до авторського ключа в ній — .spec.provides.<name>, — тож вона вказує на блок, який слід редагувати, а не на компонент, що зв’язав Recipe. Кожен запис, що виходить за межі поверхні, повідомляється в одній збірці; якщо таких кілька, знахідки групуються під provides entries that reach outside the data they are evaluated against.

Як виправити: переробіть шаблон так, щоб він брав дані лише з власних стовпів Recipe. Якщо значення залежить від виводу іншого вузла, ця залежність належить до блоку uses[].inject викликача, а не до provides цілі. Якщо значення обчислюване, винесіть вираз у запис locals: і читайте його з provides — тоді вираз житиме в одному місці. Якщо вам потрібен був простір імен розгортання (або інші дані розміщення), щоб побудувати хост між просторами імен, публікуйте тут голий хост і уточнюйте його на боці споживача за допомогою функції маршрутизації — provides виробника не повинен залежати від того, де його розгорнуто.

provides: сутності FeatureRecipe дотримується того самого правила щодо locals: її власні locals: розв’язуються перед її provides:, тож запис provides сутності FeatureRecipe також читає .locals.

Запис locals: посилається на сусідній запис, визначений пізніше в тому самому блоці

Блок locals: розв’язується в порядку запису його елементів, і запис читає лише сусідній запис, визначений вище від нього. Пряме посилання .locals.<key> на запис, який блок визначає пізніше, зупиняє збірку: компілятор ніколи не сортує й не переставляє блок, щоб посилання розв’язалося, бо тоді вивід спирався б на виведення, а не на написане автором. Без зупинки посилання розв’язалося б через політику відсутніх ключів у порожній рядок, і похідне ім’я хоста чи секрету мовчки втратило б сегмент, з якого його побудовано.

Цю помилку визначають обидва розв’язання блоку locals:, і одне з них — закріплення. Блок розв’язується для двох різних цілей: щоб власні шаблони Recipe могли читати його під час рендерингу артефакту, і щоб можна було розв’язати структуровану координату source: та закріпити артефакт, який вона називає. Помилка визначається з оголошеного порядку ключів і авторського тексту — це все, що потрібно, — тому обидва розв’язання доходять до неї й повідомляють ту саму умову: aggrega pull і збірка, що заповнює lockfile, відхиляють блок так само, як рендеринг. Під час написання варто знати два наслідки. Під час розв’язання координати читається весь блок, тож запис не в тому порядку зупиняє збірку, навіть якщо кожне поле source: літеральне й не читає жодного local. А для Recipe, чий source: є простим рядком або яка не оголошує source: взагалі, координата не розв’язується, тож у такій Recipe помилка повідомляється під час рендерингу виводу.

Повідомлення, що виводиться, для запису у власному блоці locals: компонентної Recipe. Його прив’язано до авторського ключа в Recipe, і кожен хибний запис повідомляється в одній збірці; якщо їх кілька, знахідки групуються під 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 (запис locals посилається на сусідній запис, визначений пізніше в тому самому блоці (<expression>, ключ, який він називає, — <referenced>, розв’язані на цьому місці — <the locals available here>, досягнуто через компонент <component>). визначте <referenced> вище за <key> у блоці locals)

Посилання на себе — та сама умова: ключ оголошено, але не розв’язано, — і жодна перестановка її не виправляє, тому повідомлення каже про це замість вказівки перемістити запис:

locals entry references a sibling defined later in the same block ("<expression>", the key it names is "<key>", resolved at this point "<the locals available here>", reached through the component "<component>"). a locals entry cannot read itself; compute the value from .values and .infra directly (запис locals посилається на сусідній запис, визначений пізніше в тому самому блоці (<expression>, ключ, який він називає, — <key>, розв’язані на цьому місці — <the locals available here>, досягнуто через компонент <component>). запис locals не може читати сам себе; обчисліть значення безпосередньо з .values і .infra)

Одну Recipe зв’язують багато компонентів, тож одна помилка в спільному блоці повідомляється по разу для кожного компонента, що її зв’язує, — і саме reached through the component розрізняє ці знахідки. Вони мають спільну позицію, бо всі стосуються того самого авторського запису в тому самому документі; позиція показує, де редагувати, а ім’я компонента — якому з ваших компонентів відповідає кожна знахідка. Знахідки не об’єднуються в одну, бо об’єднання сказало б, що щось не так, не сказавши, яких компонентів це стосується, а саме на це вам і треба реагувати.

Та сама помилка в блоці locals:, який оголошує recipe сутності Feature, повідомляється так само: з прив’язкою до авторського ключа в цій recipe, з іменем компонента, на якому розташоване приєднання, і з групуванням разом з усіма сусідніми записами з тією самою помилкою. Якщо recipe приєднано в кількох місцях, помилка повідомляється по разу для кожного — кожне приєднання зв’язує цей блок незалежно, тож кожне є окремим випадком, а не повтором одного.

Коли ця форма повідомляє про посилання на себе, її частина з позицією називає сам запис, що посилається, а не пізніший, бо саме там розташований ключ.

Як виправити: перемістіть запис, на який посилаються, вище за той, що його читає. Перестановка блоку locals: змінює поведінку скрізь, де один запис читає інший, тож виправлення — це саме та перестановка, яку називає повідомлення. Посилання на себе — запис, що називає власний ключ, — перестановкою не виправити; натомість обчисліть значення безпосередньо з .values і .infra, про що повідомлення й каже замість вказівки перемістити запис.

Ключ locals: не існує

Шаблон читає .locals.<key> для ключа, який блок locals: узагалі не оголошує, — через помилку в написанні або тому, що ключ було перейменовано чи видалено. Цю зупинку спричиняє кожна поверхня, що читає цей стовп: запис locals:, шаблон provides:, шаблон source: сутності Recipe, а також розв’язання структурованої координати source:, яке читає весь блок, щоб закріпити артефакт, названий координатою. Стовп locals — це відкрита мапа з ключами, тож невідомий ключ у ньому проходить перевірку кореня й інакше розв’язався б у порожній рядок; саме зупинка не дає цьому порожньому значенню потрапити до згенерованого артефакту.

Повідомлення, що виводиться, коли хибне посилання стоїть у шаблоні 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 (шаблон посилається на ключ, який блок locals не оголошує (Recipe <recipe> provides[<key>] посилається на <expression>, блок locals не оголошує <referenced>, він оголошує <the keys it does declare>). виправте назву ключа)

Повідомлення, що виводиться, коли посилання стоїть у самому записі locals:. Воно містить компонент, через який блок було прив’язано, з причини, наведеної для зупинки через порядок вище: про один спільний блок повідомляється один раз для кожного компонента, що його прив’язує, і саме це розрізняє ці результати:

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 (шаблон посилається на ключ, який блок locals не оголошує (<expression>, відсутній ключ — <referenced>, блок оголошує <the keys it does declare>, досягнуто через компонент <component>). виправте назву ключа)

Як виправити: замініть назву ключа на одну з тих, які оголошує блок; повідомлення їх перелічує. Ця зупинка відрізняється від зупинки через порядок вище, бо способи виправлення різні: жодне перевпорядкування не змусить розв’язатися ключ, якого не існує.

Перевірка читає шлях, у який посилання розв’язується, а не його написання, тож псевдонім блоку відстежується: ключ, досягнутий через крапку, яку перевизначає тіло with .locals, або через змінну, прив’язану до .locals, перевіряється точно на тих самих умовах, що й пряме написання, і так само спричиняє зупинку; так само й ключ, прочитаний із блоку в дужках, — {{ (.locals).nope }} або {{ ($.locals).nope }}, — бо дужки повертають сам блок і нічого більше. Одне написання обходить перевірку: ключ, досягнутий через виклик, результат якого текст шаблону не може назвати, — {{ index .locals "nope" }} або {{ (default dict .locals).nope }}, — бо те, що повертає такий виклик, визначається під час виконання шаблону, а не написаним. Відсутній ключ, прочитаний як поле з результату такого виклику, — форма (default dict .locals).nope — не спричиняє зупинки й рендериться як текст-заповнювач рушія шаблонів <no value>. Відсутній ключ, досягнутий через index, спричиняє зупинку, але як «A template indexes a map with a key the map does not hold (Шаблон індексує мапу ключем, якого мапа не містить)» нижче, а не як ця перевірка: index зупиняється на будь-якому ключі, якого мапа не містить. Тому index лишається способом дістатися ключа, назва якого сама обчислюється, а обчислена назва, яку блок не оголошує, усе одно повідомляється за її ключем.

Template references a root the render context does not define (Шаблон посилається на корінь, який контекст рендерингу не визначає)

Шаблон посилається на корінь верхнього рівня — перший сегмент шляху після початкової крапки, — який його контекст рендерингу не визначає: помилка в написанні, як-от {{ .valeus.port }}, або корінь, якого немає на поверхні, що її пишуть. Перевірка — це позитивний список дозволених імен коренів, і допустимий набір виводиться з форми самого контексту рендерингу, а не зберігається окремим списком поруч із ним, тож набір, який збірка відхиляє, і набір, який контекст справді надає, не можуть розійтися. Діагностика називає хибне посилання й перелічує корені, які цей контекст визначає.

Зупинка спрацьовує однаково, чи посилання записано напряму, чи обгорнуто в запасний варіант default, if, with або range, і саме обгорнута форма важить найбільше: обгортка може надати запасне значення для відсутнього ключа під визначеним коренем, але ніколи — для відсутнього кореня, тож без цієї зупинки обгорнута форма тихо розв’язалася б у порожнє значення й дала б збірці успішно завершитися. Відсутній ключ під визначеним коренем це не зачіпає: він і далі підпорядковується політиці missingkey=zero для шаблонів значень, описаній у розділі «Missing template key — asymmetric policy (Відсутній ключ шаблону — асиметрична політика)» нижче, тож ідіоми з необов’язковими ключами, як-от {{ .values.optional_field | default "fallback" }}, і далі працюють.

Та сама зупинка охоплює хибно написаний ключ на рівень нижче, під стовпом, форму якого оголошено. Деякі стовпи мають набір ключів, визначений компілятором: .context, .metadata, .inject, .workload і .boundary у контексті рендерингу Recipe та FeatureRecipe, і .manifest у шаблоні шляху. Посилання на ключ, якого один із цих стовпів не визначає, — {{ .context.nmae }}, {{ .metadata.typo }}, {{ .workload.containres }}, {{ .boundary.nmae }} — зупиняє збірку точно так само, як хибний корінь, і діагностика перелічує ключі, які цей стовп визначає. У власних шаблонах прикріплення сутності Feature .inject визначає, окрім env, file, arg і all, ще один ключ для кожного механізму доставлення, який називає власний блок inject: прикріплення: прикріплення, що записує механізм vault_ref:, читається за адресою {{ .inject.vault_ref.VAULT_PATH }}, а діагностика перелічує .inject.vault_ref серед ключів, які визначає .inject. Механізм, якого прикріплення не називає, зупиняє збірку навіть усередині if чи with, бо посилання перевіряється до запуску шаблону. Щоб прочитати механізм, якого прикріплення може не називати, захистіть його: {{ with .inject }}{{ if hasKey . "vault_ref" }}{{ index . "vault_ref" "VAULT_PATH" }}{{ end }}{{ end }}. Захищена пара збирається незалежно від того, чи називає прикріплення цей механізм і чи записує воно взагалі блок inject:, — тоді .inject нічого не містить, тож with пропускає своє тіло, тоді як hasKey безпосередньо над .inject зупинив би збірку на значенні, яке не є мапою. Усередині захисту index і далі зупиняє збірку на ключі, якого названий механізм не містить. Інші стовпи відкриті, бо те, що вони містять, — це дані з ключами, а не набір, оголошений компілятором; серед них .values, .infra, .locals, .provides, .features і .steps у контексті рендерингу та .parameters і .parent_boundary у шаблоні шляху. Відкритий стовп приймає будь-який ключ. Відсутній ключ під відкритим стовпом — це не ця зупинка: він підпорядковується політиці відсутніх ключів поверхні, описаній у розділі «Missing template key — asymmetric policy (Відсутній ключ шаблону — асиметрична політика)» нижче, тож {{ .values.optional_field | default "fallback" }} і будь-яка інша ідіома з необов’язковим ключем і далі працюють.

Які стовпи оголошені, а які відкриті, — це властивість поверхні, а не щось, на що може вплинути шаблон: компілятор зчитує це з форми контексту рендерингу, який він збирається надати. Саме це дає змогу в одному шаблоні і зупиняти збірку через помилку в написанні, і рендерити необов’язковий ключ.

Поверхня може також звузити ключ, який її стовп загалом визначає, і такий звіт — не помилка в написанні. Там, де ключ на певній поверхні несе безглузду відповідь — або таку, що належить іншому вузлу, — ця поверхня відхиляє посилання, а не розв’язує його в хибне значення, і діагностика перелічує ключі, які вона визначає. Варто знати два випадки, обидва стосуються {{ .context.rendered_name }}. У власних шаблонах прикріплення Feature ключ несе ім’я компонента-хоста так, як його повідомляє власний provider хоста, тож його відхиляють у прикріпленні до хоста, provider якого не повідомляє імені, — хоста, що розміщує лише набір артефактів, або такого, що рендериться через provider, який не виводить такого імені, — і допускають на будь-якому іншому хості. {{ .context.instance_id }} на цій поверхні допускається й називає компонент-хост, для якого розв’язується прикріплення, — саме за ним на такому хості названо власні ресурси хоста. У записах locals: сутності Recipe ключ відхиляють незалежно від того, що повідомляє provider вузла: локальне значення ділить контекст із шаблоном source: сутності Recipe, а те, чи надає вузол source, — одна з речей, від яких залежить ім’я, тож там ім’я не пропонується. Діагностика перелічує .context.instance_id як єдиний ключ, який там визначає .context; натомість зчитуйте відрендерене ім’я у записі provides: або у вбудованому шаблоні. Див. ../templates/rendered-resource-names.md, щоб дізнатися, що називає кожен із двох ключів і де кожен доступний для читання.

Повідомлення, яке виводиться, коли не визначено сам корінь:

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-name> посилається на <dotted-path>, контекст рендерингу визначає <the roots that context defines>))

А коли корінь правильний, але ключ під оголошеним стовпом — ні:

template references a root the render context does not define (template <template-name> references <dotted-path>, <pillar> defines <the keys that pillar defines>) (шаблон посилається на корінь, який контекст рендерингу не визначає (шаблон <template-name> посилається на <dotted-path>, <pillar> визначає <the keys that pillar defines>))

Як виправити: замініть посилання на одне з тих, що перелічує діагностика, — більшість звітів стосуються помилки в написанні .values, .infra або .context чи ключа під .context або .metadata. Вилучення обгортки із запасним значенням не усуне зупинку, а додавання такої ніколи її не пригнічувало; обгортка лише приховувала, яке посилання хибне. Якщо дані справді належать іншому вузлу, вони потрапляють у цей шаблон через канал inject — під’єднайте їх записом uses[].inject у споживача й зчитуйте з .context.inject, — а не через окремий корінь.

Перевірка охоплює кожну поверхню шаблонів, яку обчислює рендерер, кожну — щодо набору посилань, який визначає її власна поверхня: valuesMapping, injectMapping, workload сутностей Recipe і FeatureRecipe, тіла artifacts:, записи provides: і locals:, source:, тіла when: і with: кроків pipeline, assertions:, шаблони value: самоінʼєкції на рівні компонента в Aggregate та шаблони шляхів меж у Release (directory: / subDirectory:). Дві з цих поверхонь позначають деякі відхилення власною діагностикою, бо помилка, яку вони описують, конкретніша, ніж «цього посилання не існує»: шаблон шляху, що звертається до змінної, якої йому не надано, охоплює «Path-template references a variable outside the allowlist (Шаблон шляху посилається на змінну поза списком дозволених)» нижче, а FeatureRecipe рівня межі, що звертається до стовпа рівня компонента, — «FeatureRecipe template references a field outside its scope’s allowlist (Шаблон FeatureRecipe посилається на поле поза списком дозволених для його області)». Усе інше, що відхиляють ці дві поверхні, — зокрема хибно написаний ключ під стовпом, який вони допускають, — повідомляє про цю зупинку, тож жодна діагностика не скаже вам, що ваше посилання є чимось, чим воно не є.

An artifacts: template reads a pillar the Recipe does not declare (Шаблон artifacts: читає опору, яку Recipe не оголошує)

Шаблон запису artifacts: читає .workload або ключ під ним у сутності Recipe, яка не оголошує workload:; або читає .source чи ключ під ним у сутності Recipe, яка не оголошує source:. Обидві опори завжди присутні в контексті рендерингу artifacts — це корені, які визначає поверхня, — тож посилання правильно сформоване, і зупинка стосується відсутності оголошення, а не помилки в посиланні. Recipe, що рендерить Deployment зі свого синтезованого workload, і Recipe, що рендерить chart із джерела, мають різну форму, і тіло artifacts:, написане для однієї з них, звертається до опори, яку інша ніколи не заповнює.

Перевірка виконується до обчислення запису, і саме цей порядок робить звіт корисним. Відсутня опора надходить до шаблону як порожнє значення, тож якщо залишити справу обчисленню, збірка або не вставить нічого у вихідний файл, або завершиться з помилкою, яку шаблонізатор видає про читання ключа з порожнього значення, — і жодне з цього не називає ні опору, ні відсутнє оголошення. Відмова наперед дає змогу зупинці назвати точний вираз, що звернувся до опори, процитований так, як ви його написали.

Оголошений source:, який рендериться в порожній рядок, сприймається як відсутність джерела, бо перевірка читає джерело після обчислення його власного шаблону. Це те саме значення, з якого потім рендерить провайдер, тож Recipe, чий source: розв’язався в ніщо, не має джерела й для тіла artifacts:.

Повідомлення, що виводиться, має одну форму незалежно від того, де написано запис artifacts:. Змінюється не речення, а підписи після нього, які вказують, який документ містить запис.

Називається кожне хибне посилання в шаблоні, тож тіло, що звертається до двох відсутніх опор, повідомить вам про обидві, а не лише про ту, що трапилася першою. Кожне посилання повідомляється в документі, який оголошує запис, процитоване так, як ви його написали, і підписане вихідним файлом, до якого воно належить:

artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>) (шаблон артефакту посилається на опору, яку Recipe не оголошує (<expression>, артефакт <output-name>))

Вираз називає опору у своєму першому сегменті, і саме це підказує, якого оголошення бракує: .source.chart звертається до source:, .workload.containers — до workload:.

Запис, який оголошує власна сутність Recipe компонента, повідомляється щодо блоку artifacts: цієї Recipe.

Запис, який оголошує FeatureRecipe, — приєднаний до компонента як feature або оголошений на межі — перевіряється щодо опор, які оголошує саме ця FeatureRecipe, а не компонент-хост, повідомляється щодо блоку artifacts: цієї FeatureRecipe і має ще один підпис, що називає приєднання, яке її зв’язує:

artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>, attachment <attachment-name>) (шаблон артефакту посилається на опору, яку Recipe не оголошує (<expression>, артефакт <output-name>, приєднання <attachment-name>))

Підпис приєднання повідомляє те, чого позиція сама сказати не може: компонент може мати кілька приєднань, а приєднання, оголошене на межі, охоплює кожен компонент цієї межі. Саме речення на обох шляхах називає Recipe; позиція разом із підписом приєднання вказують, який документ відкрити.

Якщо один шаблон містить кілька посилань, кожне отримує окремий звіт під рядком, що називає спільний для них запис, і цей рядок також називає документ:

artifact <output-name> references pillars its Recipe does not declare (артефакт <output-name> посилається на опори, які його Recipe не оголошує)

artifact <output-name> references pillars the FeatureRecipe attachment <attachment-name> binds does not declare (артефакт <output-name> посилається на опори, які не оголошує FeatureRecipe, зв’язана приєднанням <attachment-name>)

Кожен із цих звітів має ту саму умову зупинки, хоч би якого документа він стосувався, тож усе, що зіставляє за умовою, а не за текстом, не бачить між ними різниці.

Як виправити: або оголосіть опору, яку читає шаблон, або припиніть її читати. Оголошення — правильне виправлення, коли тіло artifacts: відповідає цій формі Recipe: додайте workload:, якого очікують посилання шаблону на контейнер, порт чи том, або source:, шлях chart чи модуля якого шаблон інтерполює. Вилучення посилання — правильне виправлення, коли тіло написано для іншої Recipe і воно повторно використовує фрагмент, який тут не застосовний; якщо значення справді надходить з іншого місця, опублікуйте його через provides: вузла-постачальника і читайте з каналу inject, замість звертатися до опори, яку ця Recipe не заповнює. Захист посилання резервною обгорткою не знімає зупинку — відсутня опора, а не ключ під нею, — і перенесення посилання в інший запис тієї самої Recipe теж не допомагає, бо кожен запис одного блоку artifacts: обчислюється щодо тих самих опор.

Ця зупинка відрізняється від «Template references a root the render context does not define (Шаблон посилається на корінь, який контекст рендерингу не визначає)» вище, і їх варто розрізняти, бо способи виправлення різні. Та спрацьовує на корені, якого поверхня взагалі не визначає, або на помилково написаному ключі під опорою з фіксованою формою — {{ .workload.containres }} у Recipe, яка таки оголошує workload. Ця спрацьовує на правильно написаному посиланні на опору, якої просто немає.

A template reads a rendered name the node’s provider does not report (Шаблон читає відрендерене ім’я, яке провайдер вузла не повідомляє)

Шаблон читає {{ .context.rendered_name }} — ім’я, яке прив’язаний провайдер дає виводу, що він рендерить для вузла, з джерела, наданого автором, або з робочого навантаження, яке він синтезує, — на вузлі, провайдер якого такого імені не повідомляє. Посилання правильно сформоване, а ключ визначений контекстом рендерингу; відсутня лише відповідь для цього вузла.

Відмова існує тому, що альтернатива гірша за зупинку. Ім’я надходить до шаблону як звичайний рядок, тож вузол без імені відрендерив би посилання в порожнечу й видав адресу без одного сегмента — .svc.cluster.local там, де мало бути ім’я хоста, — з кодом виходу нуль і без жодного повідомлення у збірці. Такий артефакт розгортається, а те, що він називає, не існує. Відмова до будь-якого обчислення натомість повідомляє про помилку щодо шаблону, який написав автор.

Чи повідомляє провайдер вузла таке ім’я, визначає прив’язка Recipe ще до будь-якого обчислення, тож тут нічого не вгадується.

Два повідомлення, і яке з них ви отримаєте, залежить від вузла, а не від того, де ви написали посилання. Вузол, що не надає власного джерела, під провайдером, який не повідомляє для нього імені, має ресурси, названі за його ідентичністю, тож правильне значення існує, і повідомлення його називає. Вузол, що надає джерело, під провайдером, який не виводить для нього імені, не має заміни — а запропонувати там ідентичність означало б направити вас до значення, що не називає жодного з ресурсів цього вузла, тому повідомлення так і каже.

Повідомлення, що виводиться, коли вузол не надає власного джерела:

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 (шаблон читає ім’я, яке ціль дає ресурсам, що вона рендерить для вузла, а провайдер цього вузла такого імені не повідомляє; відповідний шаблон читає значення, яке надає власний провайдер вузла (“.context.rendered_name”, провайдер “<provider>”). натомість читайте {{ .context.instance_id }}: цей вузол не надає власного джерела, тож його ресурси названо за ідентичністю вузла)

А коли він надає джерело, під провайдером, що такого імені не виводить:

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 (шаблон читає ім’я, яке ціль дає ресурсам, що вона рендерить для вузла, а провайдер цього вузла такого імені не повідомляє; відповідний шаблон читає значення, яке надає власний провайдер вузла (“.context.rendered_name”, провайдер “<provider>”). напишіть значення, що не залежить від імені, яке виводить ця ціль: вона не повідомляє його для виводу, що рендерить із наданого джерела, тож тут нема чого читати)

Якщо посилання стоїть у шаблоні, відмінному від запису provides:, повідомлення додатково називає поле, у якому його написано, — field "valuesMapping", field "artifacts[probe.tf.json]", — бо ключ запису artifacts: є іменем вихідного файлу й містить символ, яким позиція розділяє власні сегменти, тож позиція зупиняється на блоці, що містить запис.

Які шаблони охоплено: кожен шаблон, який Recipe пише безпосередньо, — його записи provides:, його valuesMapping:, тіло workload:, кожен запис artifacts:, а також with: і when: кожного кроку конвеєра. Одна поверхня шаблонів лишається поза перевіркою: запис valuesMapping:, workload: чи artifacts:, наданий через $import:, — чи імпорт називає локальний файл, чи запис бібліотеки, — не має тексту в Recipe, доки рендеринг його не розв’яже, тож посилання в такому тілі рендериться як порожнє значення, а не зупиняє збірку.

Як виправити: читайте ключ, який називає повідомлення. Якщо вивід вашого вузла — щось збудоване для нього під провайдером, що не повідомляє імені, — синтезоване робоче навантаження, розміщений набір артефактів, — то {{ .context.instance_id }} є ім’ям, яке ці ресурси справді мають, і це правильне значення, а не запасний варіант. Якщо ваш вузол надає власний чарт або модуль і повідомлення не пропонує заміни, то ім’я, до якого ви тяглися, цей провайдер не виводить: опублікуйте щось, що від нього не залежить, або назвіть ресурс у наданому джерелі й зчитайте це ім’я зі значення, яке ви задали. На сторінці ../templates/rendered-resource-names.md описано, які провайдери повідомляють ім’я і, для кожного з решти, чому його немає.

A template reads its callers’ render facts without declaring it (Шаблон читає факти рендерингу своїх викликачів, не оголосивши цього)

Шаблон у FeatureRecipe, приєднаному до компонента, читає render_facts під .context.used_by — те, що компоненти, які під’єднуються до хоста приєднання, повідомили про власний рендеринг, — а FeatureRecipe не задає readsCallerRenderFacts: true.

Саме ключ визначає, коли рендериться приєднання. Без нього приєднання рендериться одразу після компонента, до якого його приєднано, а під’єднаний компонент, що йде пізніше в порядку збірки, на той момент ще не відрендерено, тож того, що він видав, там бути не може. Відмова від шаблону до будь-якого рендерингу повідомляє про відсутнє оголошення щодо написаного вами поля, замість збірки, шаблон якої читає те, що видали лише деякі з викликачів.

Повідомлення, що виводиться:

template reads its callers’ render facts, but the FeatureRecipe does not set readsCallerRenderFacts (<reference>, written in <field>) (шаблон читає факти рендерингу своїх викликачів, але FeatureRecipe не задає readsCallerRenderFacts (<reference>, написано в <field>))

Посилання наводиться відносно з’єднання, з якого його прочитано, — .render_facts або .render_facts.<name>, — бо шаблон читає викликачів по одному з’єднанню, усередині {{ range .context.used_by }} або з одного вибраного з’єднання. Поле називає блок, у якому написано шаблон: valuesMapping, workload або artifacts[<output-name>]. Про with: чи when: кроку конвеєра, що читає ті самі факти, натомість повідомляє наступний запис, хоч би що задавав FeatureRecipe, бо задання ключа не дозволило б крокові їх прочитати. Якщо факти читають кілька полів, кожне отримує власне повідомлення під рядком, що називає їхнє спільне:

attachment templates reading their callers’ render facts without declaring it (шаблони приєднання читають факти рендерингу своїх викликачів, не оголосивши цього)

Як виправити: задайте readsCallerRenderFacts: true у spec FeatureRecipe. Тоді його приєднання рендеряться після рендерингу всіх компонентів, і більше нічого в тому, що вони рендерять, не змінюється, — див. сторінку сутності FeatureRecipe. Ключ і є контрактом, а ця зупинка лише допомагає знайти шаблон, якому він помітно потрібен: перевірка читає шаблон як написано, тож посилання, збудоване під час виконання шаблону, або написане у вмісті, імпортованому з файлу чи бібліотеки, не зупиняє збірку, — однаково задайте ключ на такому FeatureRecipe. Шаблон, що читає поле з назвою render_facts з якогось іншого списку поруч із .context.used_by, також зупиняє збірку, як і шаблон, що читає власні факти хоста як .render_facts усередині {{ with .context }} поруч із ним, — пишіть власні факти хоста повністю як .context.render_facts, що ніколи не сприймається як факти викликачів; задання ключа усуває обидва випадки ціною лише пізнішого рендерингу.

FeatureRecipe, що рендериться один раз для межі (executionScope: boundary), тут не перевіряється: шаблони, які створюють його ресурси, не мають .context для читання, а посилання на нього натомість відхиляється як поле поза дозволеним списком його області.

A pipeline step reads its callers’ render facts (Крок конвеєра читає факти рендерингу своїх викликачів)

with: або when: кроку конвеєра у FeatureRecipe, приєднаному до компонента, читає render_facts під .context.used_by — те, що компоненти, які підключаються до хоста приєднання, повідомили про власний рендеринг.

Крок конвеєра ніколи не бачить цих підключень. Крок може переписувати власні документи компонента-хоста, а власний вивід компонента лишається тим самим, хто б до нього не підключався, тому шаблони кроку обчислюються без .context.used_by — для кожного FeatureRecipe, незалежно від того, чи встановлює він readsCallerRenderFacts: true. Цей ключ визначає, коли рендериться приєднання, а не те, що бачить крок. Отже, крок, що читає факти своїх викликачів, не прочитав би нічого, і збірка зупиняється ще до будь-якого рендерингу, а не рендерить це читання як порожнє значення.

Повідомлення, що виводиться:

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>) (крок конвеєра читає факти рендерингу своїх викликачів, але крок конвеєра не читає компоненти, що під’єднуються до його хоста; він читає лише власні факти рендерингу хоста (<reference>, записано в <field>))

Посилання наводиться відносно підключення, з якого його прочитано, — .render_facts або .render_facts.<name> — як і в записі вище, а поле називає крок за його id: pipeline[<step>].with або pipeline[<step>].when. Якщо факти читають кілька кроків, кожен отримує окремий звіт під рядком, що називає їхнє спільне:

pipeline steps reading their callers’ render facts (кроки конвеєра, що читають факти рендерингу своїх викликачів)

Як виправити: у кроці читайте власні факти рендерингу хоста в .context.render_facts, записаному повністю, — вони походять із власного рендерингу хоста, тож їх читання ні від кого, хто до нього підключається, нічого не робить залежним. Натомість читайте факти викликачів у шаблонах, що створюють власні ресурси приєднання, — його valuesMapping:, workload: або artifacts: — із встановленим readsCallerRenderFacts: true, як описує сторінка сутності FeatureRecipe. Саме лише встановлення ключа цієї зупинки не усуває. Перевірка читає шаблон у тому вигляді, як його написано, з обмеженнями, описаними в записі вище: посилання, побудоване під час виконання шаблону, або записане у вмісті, імпортованому з файлу чи бібліотеки, зупинки не спричиняє, а крок, що читає поле з назвою render_facts з якогось іншого списку поряд із .context.used_by або власні факти хоста як .render_facts усередині {{ with .context }} поруч із ним, так само спричиняє зупинку.

FeatureRecipe, що рендериться один раз для межі (executionScope: boundary), тут не перевіряється — з причини, наведеної в записі вище.

A template reads its targets’ render facts without declaring it (Шаблон читає факти рендерингу своїх цілей, не оголосивши цього)

Шаблон у FeatureRecipe, приєднаному до компонента, читає render_facts під .context.uses — те, що компоненти, до яких під’єднано хост приєднання, повідомили про власний рендеринг, — а FeatureRecipe не встановлює readsTargetRenderFacts: true.

Ключ визначає дві речі. Він змушує приєднання рендеритися після того, як відрендерено всі компоненти: без нього приєднання рендериться одразу після компонента, до якого воно приєднане, а ціль, що йде пізніше в порядку збірки, на той момент ще не відрендерена. І саме він розміщує факти кожної цілі на підключеннях, які читає приєднання: без нього жоден запис .context.uses взагалі не містить .render_facts. Відхилення шаблону до будь-якого рендерингу повідомляє про відсутнє оголошення щодо поля, яке ви написали, замість збірки, шаблон якої нічого не читає там, де очікував факти цілі.

Повідомлення, що виводиться:

template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFacts (<reference>, written in <field>) (шаблон читає факти рендерингу компонента, з яким з’єднано його хост, але FeatureRecipe не задає readsTargetRenderFacts (<reference>, записано в <field>))

Посилання — те, яке написав шаблон: під псевдонімом одного підключення повністю — .context.uses.<alias>.render_facts або .context.uses.<alias>.render_facts.<name> — або, якщо шаблон читає підключення по одному, усередині {{ range .context.uses }}, {{ with .context.uses.<alias> }} чи з одного обраного підключення, відносно цього підключення: .render_facts або .render_facts.<name>. Поле називає блок, у якому написано шаблон: valuesMapping, workload або artifacts[<output-name>]. Про with: або when: кроку конвеєра, що читає ті самі факти, натомість повідомляє наступний запис, хоч би що встановлював FeatureRecipe. Якщо факти читають кілька полів, кожне отримує окремий звіт під рядком, що називає їхнє спільне:

attachment templates reading the render facts of the components their host is wired to, without declaring it (шаблони приєднань, що читають факти рендерингу компонентів, до яких під’єднано їхній хост, не оголосивши цього)

Як виправити: встановіть readsTargetRenderFacts: true у spec FeatureRecipe — readsCallerRenderFacts: true цієї зупинки не усуває, бо розміщує факти на компонентах, що підключаються до хоста, а не на тих, до яких під’єднано хост. Це рендерить його приєднання після рендерингу всіх компонентів і розміщує факти кожної цілі на її підключенні, нічого більше не змінюючи в тому, що вони рендерять, — див. сторінку сутності FeatureRecipe. Ключ — це контракт, а ця зупинка лише допомагає знайти шаблон, якому він явно потрібен: перевірка читає шаблон у тому вигляді, як його написано, тож посилання, побудоване під час виконання шаблону, або записане у вмісті, імпортованому з файлу чи бібліотеки, зупинки не спричиняє — усе одно встановіть ключ на такому FeatureRecipe. Шаблон, що взагалі читає .context.uses і також читає поле з назвою render_facts з якогось іншого значення — зокрема факти викликача всередині {{ range .context.used_by }}, — так само спричиняє зупинку; встановіть ключ, а також readsCallerRenderFacts, якщо шаблон читає факти своїх викликачів.

FeatureRecipe, що рендериться один раз для межі (executionScope: boundary), тут не перевіряється — з причини, наведеної в записі про викликачів вище.

A pipeline step reads its targets’ render facts (Крок конвеєра читає факти рендерингу своїх цілей)

with: або when: кроку конвеєра у FeatureRecipe, приєднаному до компонента, читає render_facts під .context.uses — те, що компоненти, до яких під’єднано хост приєднання, повідомили про власний рендеринг.

Крок читає підключення, які створює його хост, так, як їх читає власний Recipe хоста, і ніколи — факти рендерингу їхніх цілей, для кожного FeatureRecipe, незалежно від того, чи встановлює він readsTargetRenderFacts: true. Крок може переписувати власні документи компонента-хоста, а власний рендеринг хоста читає те, що публікують його цілі, а не те, що вони вивели, тому шаблони кроку обчислюються без цих фактів. Отже, крок, що їх читає, не прочитав би нічого, і збірка зупиняється ще до будь-якого рендерингу, а не рендерить це читання як порожнє значення.

Повідомлення, що виводиться:

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>) (крок конвеєра читає факти рендерингу компонента, з яким з’єднано його хост, але крок конвеєра читає лише власні факти рендерингу хоста (<reference>, записано в <field>))

Посилання наводиться так само, як у записі вище, а поле називає крок за його id: pipeline[<step>].with або pipeline[<step>].when. Якщо факти читають кілька кроків, кожен отримує окремий звіт під рядком, що називає їхнє спільне:

pipeline steps reading the render facts of the components their host is wired to (кроки конвеєра, що читають факти рендерингу компонентів, до яких під’єднано їхній хост)

Як виправити: у кроці читайте власні факти рендерингу хоста в .context.render_facts, записаному повністю. Натомість читайте факти цілей у шаблонах, що створюють власні ресурси приєднання, — його valuesMapping:, workload: або artifacts: — із встановленим readsTargetRenderFacts: true, як описує сторінка сутності FeatureRecipe. Саме лише встановлення ключа цієї зупинки не усуває. Перевірка читає шаблон у тому вигляді, як його написано, з обмеженнями, описаними в записі вище.

FeatureRecipe, що рендериться один раз для межі (executionScope: boundary), тут не перевіряється — з причини, наведеної в записі про викликачів вище.

Cross-node type safety violation via selector: (Порушення безпеки типів між вузлами через selector:)

Одна зупинка охоплює два вирази міток, які автор каталогу пише, щоб обмежити, що можна під’єднувати або приєднувати, бо обидва зазнають невдачі однаково: набір міток не задовольняє виразу, оголошеному сутністю каталогу.

Ребро uses:, ціль якого не задовольняє selector: свого сокета. Сокет usesSchema оголошує поле selector:, яке виключає цільовий Component, приєднаний на іншому кінці ребра. Селектор — це спосіб автора каталогу сказати «цей сокет приймає лише цілі, мітки яких відповідають цьому виразу»; ребро, яке проходить пошук за назвою сокета, але не задовольняє виразу селектора, є порушенням безпеки типів.

Повідомлення, що виводиться:

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. (порушення селектора: вираз, оголошений на сокеті, не задовольняють мітки цілі. Додайте мітки, яких вимагає селектор, до типу компонента цілі або під’єднайте сокет до компонента, який уже має ці мітки.)

Приєднання, компонент якого не задовольняє appliesTo: сутності Feature. Feature оголошує, до яких компонентів його можна приєднати, в appliesTo: і в appliesToAnyOf:. Вимоги одного виразу мають виконуватися разом, а альтернативи — альтернативно, і достатньо будь-якої з них; обидві поверхні мають виконуватися, а поверхню, яку Feature пропускає, задовольняє що завгодно. Приєднання, компонент якого має мітки, яких оголошення Feature не допускає, — порушення того самого класу, що й випадок із ребром вище.

Повідомлення, що виводиться:

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. (порушення селектора: вираз appliesTo, оголошений сутністю Feature, не задовольняють мітки компонента. Додайте до типу цього компонента мітки, яких вимагає appliesTo сутності Feature, або підключіть Feature, умови застосовності якої компонент уже задовольняє.)

Будь-який із виразів також може бути записано у формі, яку граматика міток узагалі не може прочитати. Про це повідомляє та сама зупинка, останнім значенням якої є причина, з якої вираз не вдалося прочитати, а не набір міток, який його не задовольнив, — саме це відрізняє вираз, який не вдалося обчислити, від виразу, який обчислено й результат якого хибний:

selector violation ("", declared by Feature "", which could not be evaluated: ""). Correct the appliesTo selector on the Feature’s catalog entity. (порушення селектора: вираз appliesTo, оголошений сутністю Feature, не вдалося обчислити. Виправте селектор appliesTo у сутності каталогу Feature.)

Селектор сокета, який граматика не може прочитати, теж відхиляється ще до того, як щось під’єднається до сокета. aggrega validate — над усім каталогом або над однією сутністю Component чи Feature — читає кожен селектор сокета, який оголошує власний документ сутності, і відхиляє той, який граматика не може прочитати, за цією самою умовою незалежно від того, чи проведено через сокет будь-яке ребро:

selector violation ("", declared on socket "", which could not be evaluated: ""). Correct the selector on the socket’s declaration in the component type’s usesSchema. (порушення селектора: селектор, оголошений у сокеті, не вдалося обчислити. Виправте селектор в оголошенні сокета в usesSchema типу компонента.)

Для сокета сутності Feature спосіб виправлення натомість називає usesSchema цієї сутності Feature. До сокета ще ніщо не під’єднано, тож помилка — у сутності каталогу: вона класифікується як CATALOG_ERROR і називає файл сутності.

Зупинка містить ключ авторингу, якого вона стосується, — запис сокета uses: або запис features:, що називає приєднання, — разом із файлом, який його оголошує, тож позиція, про яку вона повідомляє, — це запис, який ви редагуєте, а не початок документа. Component, написаний усередині підсистеми, позиціонується в підсистемі, під якою його написано, рівень за рівнем. Приєднання позиціонується в записі features:, який його написав, у документі, який його написав, і відноситься до автора цього документа: власний блок компонента або блок підсистеми в сутності Aggregate — помилка розробника; а для приєднання, яке створює лише Release, — його запис для компонента або блок features: межі, що містить компонент, — помилка оператора. Якщо приєднання пишуть обидва документи, воно позиціонується там, де названо його type, що Aggregate робить завжди. Приєднання, записане на підключенні, позиціонується в його ключі під features: цього підключення, у документі, який його написав, — у записі підключення в Aggregate або в записі для ребра в Release для приєднання, яке створює лише Release. Feature, який лише Release приєднує до компонента, якого його оголошення не допускає, виглядає так:

[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.

а те саме підключення, записане на компоненті в Aggregate, виглядає так: [DEVELOPER_ERROR E0007] aggregate.yaml at .spec.components.app.features.metrics. Підключення, створене розгортанням на основі анотацій, не записане жодним записом features:, тому його позицією є власний ключ features: компонента в документі, що оголошує компонент, і воно вважається помилкою розробника.

Як виправити порушення ребра: або спрямуйте ребро uses: до Component, мітки якого задовольняють селектор, або змініть вираз селектора в сутності каталогу, щоб він приймав потрібний клас цілей. Перегляньте metadata.labels цільового Component за допомогою aggrega inspect, щоб перевірити, які мітки він має.

Як виправити порушення приєднання: або приєднайте Feature до компонента, мітки якого допускає його оголошення, або розширте appliesTo: сутності Feature — додавши альтернативу під appliesToAnyOf:, якщо Feature справді обслуговує більше ніж один клас компонентів. Якщо компонент мав би відповідати, але не відповідає, бракує зазвичай мітки: перегляньте його за допомогою aggrega inspect і додайте те, чого вимагає вираз, у metadata.labels сутності Component.

Unknown provider (Невідомий провайдер)

Recipe оголошує capability: <name>, де <name> не називає жодного провайдера, якого обслуговує компілятор. Компілятор не може передати рендеринг провайдерові, про якого ніколи не чув.

Повідомлення, що виводиться:

unknown provider: <provider-name>

Як виправити: перевірте правильність написання назви провайдера — cloudformation, compose, helm, helm-chart і terraform є назвами, які обслуговують вбудовані плагіни провайдерів. Якщо ви мали на увазі власний корпоративний провайдер, переконайтеся, що Plugin для рендерингу провайдера, який обслуговує цю назву (pluginType: provider з назвою в його spec.provider.capabilities), присутній у робочому просторі каталогу, на який спрямовано збірку.

A capability is served by more than one provider plugin (Можливість обслуговує більше ніж один плагін провайдера)

Збірка доходить до можливості — або pull розв’язує таку, — яку обслуговує більше ніж один Plugin для рендерингу провайдера (pluginType: provider, кожен із яких перелічує цю можливість у своєму spec.provider.capabilities), а робочий простір не вибрав, який із них її рендерить. Замість довільно вибирати провайдера збірка зупиняється й називає обох кандидатів. Каталог, що містить два плагіни для однієї можливості, допустимий — два видавці можуть кожен постачати плагін для helm або compose, і каталог приймає обидва. Неоднозначність виявляється лише в точці використання: зупинка спрацьовує, коли збірка або pull справді доходить до спірної можливості, а не під час завантаження.

Повідомлення, що виводиться. Спершу йде правило, яке зупинило збірку, а за ним — подробиці: яка можливість, які кандидати й яку прив’язку записати:

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 (можливість обслуговує більше ніж один плагін провайдера; додайте запис plugins.providers, щоб вибрати один)

Як виправити: додайте в конфігурацію робочого простору запис plugins.providers із ключем-можливістю, значення якого вибирає ідентичність плагіна, що її рендерить. Залиште обидва плагіни у федеративному каталозі; прив’язка вказує цьому робочому простору, якому з них передавати спірну можливість.

The plugin serving a provider cannot assemble what that provider combines (Плагін, що обслуговує провайдер, не може зібрати те, що цей провайдер об’єднує)

Провайдер визначає, що стається з повузловим виводом групи диспетчеризації: вивід кожного вузла записується безпосередньо за шляхом диспетчеризації, фрагменти згортаються в один документ або кожен вузол розміщується на власній позиції всередині однієї охопної структури. Якщо провайдер визначає, що вивід об’єднується — об’єднаний файл compose, umbrella-чарт, — плагін, що його обслуговує, має пропонувати експорт, який виконує об’єднання. Ця зупинка спрацьовує, коли його немає: плагін оголошує повузловий рендеринг (render_node) і не має відповідного assemble_boundary, тож вузли групи можна відрендерити, але їхній вивід не можна об’єднати.

Обидві сторони цієї розбіжності належать плагіну. Те, що стається з виводом групи диспетчеризації, — частина того, що плагін повідомляє про себе під час завантаження, а експорт, який виконав би об’єднання, — один із записів у spec.exports сутності Plugin, який звіряється з тим самим повідомленням, — тож зупинка називає плагін, що заявляє збирання, якого не забезпечує його поверхня експортів.

Збірка зупиняється, а не пропускає збирання. Пропуск записав би фрагмент кожного вузла за шляхом, де очікувався один артефакт, і повідомив би про успіх, а ніщо далі не зможе відрізнити ці фрагменти від плоского повузлового виводу, який навмисно видає провайдер без заявленого збирання, — тож відсутній артефакт виявився б там, де вивід застосовується, а не під час збірки.

Група диспетчеризації без шляху диспетчеризації пропускається. Вивід, записаний без шляху, є повузловим, тож там нічого не збирається, і заяві про об’єднання нема чим керувати.

Повідомлення, що виводиться, — по одному висновку на кожну проблемну групу диспетчеризації, з назвою провайдера та шляхом, за яким ця група збирається:

provider expected to assemble its dispatch group provides no boundary assembler ("<provider>", dispatch path "<path>") (провайдер, який мав зібрати свою групу диспетчеризації, не надає збирача меж)

Якщо проблемних груп диспетчеризації кілька, висновки надходять разом у звіті dispatch groups whose provider offers no boundary assembler.

Як виправити: обслуговуйте capability плагіном, який оголошує і render_node, і assemble_boundary, — див. ../entities/plugin.md щодо поверхні створення spec.exports та ../schema/plugins/wasm-provider.md щодо того, що отримує експорт збирання. Якщо плагін пишете ви, узгодити обидві сторони — ваше завдання: додайте експорт збирання або не заявляйте збирання й дозвольте виводу кожного вузла потрапляти за шляхом диспетчеризації без об’єднання. Якщо ви використовуєте опублікований плагін, виберіть версію, що пропонує обидва експорти, або плагін, провайдер якого не заявляє збирання для цієї capability.

A boundary-level Feature’s output reaches no assembled file (Вивід сутності Feature рівня межі не потрапляє до жодного зібраного файлу)

Сутність Feature, прикріплена під features: межі, чий FeatureRecipe оголошує executionScope: boundary, рендериться один раз для всієї межі, а її вивід потрапляє до каталогу, у який для неї обчислюються власні directory: і subDirectory: межі. Провайдер, що зводить свій вивід в один документ, — compose в один docker-compose.yaml, cloudformation в один стек, — записує внесок такої сутності Feature лише як частину файлу, який він там збирає з компонентів межі. Цей файл існує лише тоді, коли вивід принаймні одного компонента потрапляє до того самого каталогу за того самого провайдера.

Його немає, коли компоненти межі потрапляють деінде: коли вони розташовані у вкладених межах, чий subDirectory: надсилає їх деінде, — скажімо, "{{ .component_id }}", щоб кожен компонент отримав власний файл, — або в каталозі, який вивід сутності Feature не поділяє. У каталозі сутності Feature нічого не збирається, тож її вивід не було б записано нікуди — для мосту compose це сервіс шлюзу, якого не містить жоден файл, — а збірка повідомила б про успіх. Натомість збірка зупиняється.

Сутність Feature, чий провайдер записує кожен внесок окремими файлами, — helm, helm-chart і terraform, — це не зачіпає: ці файли записуються незалежно від того, чи щось збирається поруч із ними.

Повідомлення, що виводиться, — одна знахідка на кожну порушну сутність Feature, прив’язана до її запису під features: межі й така, що називає межу, сутність Feature, шлях диспетчеризації, куди спрямовано її вивід, і провайдер:

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 (вивід Feature рівня межі спрямовано до шляху диспетчеризації, де нічого не збирається; прикріпіть Feature до межі, шлях виводу якої отримує й її компоненти, або надайте компонентам межі каталог, куди спрямовано вивід Feature)

Міст compose, прикріплений до батьківської межі bridge, єдина дочірня межа якої розміщує кожен компонент під subDirectory: "{{ .component_id }}", виводить:

[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

Якщо порушних сутностей Feature більше ніж одна, знахідки надходять разом під звітом boundary-level Features whose output is routed to a dispatch path nothing assembles.

Як виправити: зробіть каталог сутності Feature тим, до якого потрапляють і компоненти її межі. Або прикріпіть сутність Feature до межі, власний шлях виводу якої отримує ці компоненти, або надайте компонентам каталог, куди спрямовано вивід сутності Feature, — для дочірніх меж directory: "{{ .parent_boundary.directory }}" без власного subDirectory:, щоб вони поділяли файл батьківської межі. Повідомлення називає каталог, куди спрямовано вивід сутності Feature, — саме його й треба поділити.

Path-template references a variable outside the allowlist (Шаблон шляху посилається на змінну поза списком дозволених)

Шаблон directory: або subDirectory: посилається на ім’я змінної, якого немає в списку дозволених змінних шаблонів шляхів, — наприклад, через одруківку на кшталт {{ .parmaeters.region }} або через поле, яке існує в контексті рендерингу Recipe, але не доступне шаблонам шляхів (як-от .context.inject чи .values). Та сама зупинка охоплює {{ .component_id }} у шаблоні directory:: змінна існує, і шаблони subDirectory: можуть її читати, але directory: межі обчислюється один раз для всієї межі, а не один раз для кожного компонента, тож змінна рівня компонента там зробила б згенерований шлях залежним від того, який компонент випадково обчислено першим.

Шаблони шляху перевіряються під час розбору, до початку будь-якого рендерингу, щодо змінних, які визначає контекст шаблону шляху, за винятком тих, які відхиляє конкретна поверхня. Компілятор також обчислює шаблони шляху із семантикою missingkey=error, тож посилання, дозволене, але не визначене під час обчислення, дає явну помилку, а не непомітно підставляє порожній рядок у шлях каталогу.

Ця зупинка стосується змінної. Помилково набраний ключ під дозволеною змінною — {{ .manifest.recipe_nmae }} — натомість повідомляє вище «Template references a root the render context does not define», називаючи ключі, які визначає .manifest, бо саму змінну було допущено, а помилковим був лише ключ.

Повідомлення, що виводиться:

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>") (шаблон шляху посилається на поле поза задокументованим списком дозволених)

Як виправити: виправте назву поля на одну зі списку дозволених для шаблонів шляху або видаліть посилання. Список дозволених для directory:: {{ .capability }}, {{ .boundary_name }}, {{ .parameters.X }}, {{ .manifest.recipe_name }} і {{ .parent_boundary.* }}; subDirectory: додає {{ .component_id }}. Інші поверхні (valuesMapping у Recipe, injectMapping у FeatureRecipe тощо) використовують іншу форму контексту; посилання на .context.*, .values, .infra чи .locals навмисно не доступні шаблонам шляху, бо виведення шляху — структурне питання, а не питання рендерингу значень.

Path collision: two contributors emit at incompatible paths (Колізія шляхів: два учасники виводять за несумісними шляхами)

Дві межі, оголошення шляхів яких обчислюються в той самий шлях збирання, маршрутизуються через різні провайдери. Обидві збираються там, і кожна записує файли, про які інша нічого не знає, тож одна непомітно витісняє іншу на диску — а збірка, що створила витіснений вивід, виглядає успішною.

Типовий subDirectory: дає кожному провайдеру власний підшлях, тож два провайдери потрапляють в один шлях лише там, де оголошення написано так, щоб вони обчислювалися однаково: скажімо, дві межі мають спільний directory: і обидві фіксують subDirectory: на тому самому літералі.

Повідомлення, що виводяться. Для кожної межі-учасника повідомляється один висновок, тож кожна межа, вивід якої потрапив у шлях, названа окремо, а не згорнута у список всередині одного повідомлення. Помилка полягає в зустрічі двох провайдерів в одному шляху, тож висновків завжди щонайменше два, і вони надходять разом у звіті, що вказує їхнє спільне:

assembly paths reached by more than one provider (шляхи збирання, у які потрапляє більш ніж один провайдер)

Кожен висновок називає шлях, межу, вивід якої в нього потрапив, і провайдер, через який ця межа маршрутизується:

dispatch path produced multiple provider outputs ("<path>", boundary "<boundary>", provider "<provider>") (шлях диспетчеризації отримав виводи кількох провайдерів)

Збірка, межі api-net і db-net якої обидві оголошують directory: ./dist/shared і subDirectory: merged, причому одна маршрутизується через helm, а інша — через compose, виводить:

[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")

Звіт містить короткий код, а кожен висновок під ним — лише свою категорію; таку форму має кожен звіт про зібрані збої — граматику див. в error-translation.md.

Як виправити: або дайте кожній межі окремий directory: (щоб вони збиралися в різні шляхи), або залиште subDirectory: типовим, щоб вивід кожного провайдера потрапляв у власний підшлях. Патерн compose-bridge навмисно зводить дві підмежі в один шлях збирання; цей патерн вимагає, щоб обидві межі були спрямовані на той самий провайдер і мали сумісні анотації, розв’язані каскадом.

A boundary’s output directory is not a directory beneath the output root (Вихідний каталог межі не є каталогом усередині кореня виводу)

directory: і subDirectory: межі обчислюються й об’єднуються в каталог, у який записується її вивід, і цей шлях нормалізується один раз: out/a, out//a, ./out/a і out/a/ — це один каталог. Якщо нормалізований шлях не є каталогом усередині кореня виводу, збірка зупиняється, перш ніж щось буде записано. Це шлях, що виходить за межі кореня виводу (.., ../escape, a/../..), абсолютний шлях (/srv/out) або шлях, що взагалі не називає каталогу: порожнє значення чи таке, що нормалізується до самого кореня виводу, як-от directory: "." з вимкненим підкаталогом.

Шлях перевіряється таким, яким його обчислено, тож оцінюється результат шаблону, а не написаний текст. Повідомлення називає поле, з якого походить помилка, — directory:, якщо вже сам каталог виходить за межі кореня виводу або якщо до нього не приєднано жодного підкаталогу, і subDirectory: в інших випадках, — разом зі значенням, до якого обчислилося це поле, і шляхом, який воно дало.

Повідомлення, що виводиться:

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 (вихідний каталог межі не є каталогом усередині кореня виводу (Release, межа, directory:, шлях виводу). Вкажіть каталог усередині кореня виводу, наприклад «deploy/prod», — без початкового «/», без «..», що виходить вище нього, і не сам корінь виводу)

Якщо помилка в підкаталозі, третє значення натомість має вигляд subDirectory: "<value>".

Як виправити: запишіть поле, яке називає повідомлення, як каталог усередині кореня виводу. Каталог, який мав би бути поруч із коренем виводу, слід натомість розмістити всередині нього. Щоб записати вивід межі безпосередньо в її directory:, задайте subDirectory: "." — сам каталог при цьому все одно має називати власний каталог.

A boundary-level Feature is named . or .. (Feature рівня межі має назву . або ..)

Provider, що дає кожному учаснику власний каталог, — terraform у modules/ і helm-chart у charts/, — розміщує Feature, приєднану до межі, у каталозі, названому лише за екземпляром, поруч із компонентами межі. Ключ features: межі допускає . і .., але жодне з них не є назвою каталогу: . помістило б файли Feature в каталог, що містить усіх учасників, а .. — у каталог над ним, тож файли опинилися б поза позицією, яку provider відвів для Feature. Натомість збірка зупиняється. Будь-яка інша назва не зачіпається, зокрема назва з крапкою, як-от audit.v2.

Повідомлення, що виводиться:

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” (ім’я екземпляра Feature рівня межі не є іменем каталогу (Release, межа, функція). Перейменуйте екземпляр Feature у features межі на звичайне ім’я, наприклад «audit»)

Як виправити: перейменуйте екземпляр у features: межі на звичайну назву.

Instance-ID collision across boundaries assembling to the same path (Колізія ідентифікаторів екземплярів між межами, що збираються за одним шляхом)

Дві межі, що збираються в один кортеж (шлях, provider), додають компоненти з однаковими ідентифікаторами екземплярів. Об’єднана збірка не може розрізнити два фрагменти компонентів — один Helm chart не може містити два Deployments з назвою web-server, а один файл docker-compose не може містити два сервіси з назвою api.

Повідомлення, що виводиться:

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 (кілька учасників мають спільний ID екземпляра за одним шляхом диспетчеризації: шлях диспетчеризації провайдера вже містить вузол (межі-учасники:); ID екземплярів компонентів мають бути унікальними в межах групи збирання)

Як виправити: перейменуйте один із конфліктних компонентів в Aggregate або рознесіть дві межі на окремі шляхи directory:, щоб кожен екземпляр компонента потрапив у власну збірку.

Two contributors write the same output path (Два учасники записують за одним вихідним шляхом)

Два учасники однієї збірки створюють файл за одним вихідним шляхом. Це відрізняється від колізії ідентифікаторів екземплярів вище: компоненти мають різні назви, і збірка може їх розрізнити, — за одним шляхом опиняються саме файли, які вони виводять. Найчастіше так стається, коли provider записує вивід кожного учасника поруч, а не в окрему позицію для кожного компонента, тож два компоненти, Recipes яких виводять файл з однаковою назвою (скажімо, два записи artifacts: з назвою main.tf), зустрічаються за одним шляхом. Так само з файлом учасника може зіткнутися й власний вивід збирача.

Чи зіткнуться два учасники, що виводять файл з однаковою назвою, залежить від того, де їх розміщує provider. Provider, що вкладає кожного учасника у власну позицію у збірці, тримає два однойменні файли окремо; provider, що записує учасників поруч, — ні. Порівнюється кінцевий шлях, за яким було б записано файл, а не назва, яку вивів учасник, тож про вкладений випадок не повідомляється.

Збірка зупиняється, а не записує один із двох файлів, відкидаючи інший. Правильного мовчазного розв’язання не існує: перейменування файлу чи додавання суфікса вигадало б назву, якої ніхто не задавав, а злиття їхнього вмісту вигадало б документ, якого ніхто не писав. Повідомляється про кожен конфліктний шлях і називається кожен учасник, що записує за ним, тож одна збірка показує вам усю картину, а не по одній колізії за раз.

Повідомлення, що виводяться. Для кожного конфліктного шляху повідомляється одна знахідка — один раз, незалежно від того, скільки меж постачали збірку, у якій це сталося, — тож збірка, учасники якої зустрілися на двох шляхах, повідомляє вам про обидва, і жодна колізія не повідомляється двічі:

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>") (колізія зібраного виводу: два учасники записують той самий шлях виводу (шлях виводу, записаний учасниками, зібраний у межах))

Кожен учасник називається за тим, чим він є, і це вказує, де записано його назву: component <name> для екземпляра компонента, feature <name> для feature, приєднаної до межі, і the <provider> assembly для власного об’єднаного виводу збірки. Учасники перелічуються в порядку назв, тож речення однакове в кожній збірці тих самих вхідних даних.

Під це правило підпадає й файл, який Recipe додає до спільного виводу межі. Блок boundary: у Recipe записує свої файли поруч із власним зібраним виводом provider, по одному разу на назву файлу. Кілька компонентів, що оголошують одну назву з ідентичними байтами, — це один файл, і вони ніколи не конфліктують; оголошення з різними байтами дає колізію тут, з назвою файлу та кожного компонента, що його оголосив, і так само назва, яку записує сама збірка provider, — скажімо, aggrega.modules.tf для terraform, що називає the terraform assembly серед учасників. Файл, який кілька компонентів оголосили однаково і який зустрівся з власним файлом збірки, називається з усіма ними, як component <name-1> and component <name-2>.

Межі, які постачали збірку, теж називаються, і їх перелічують, а не виокремлюють одну. Межі, оголошення directory: яких обчислюються однаково, збираються як одна, і ніщо в колізії не вказує, у якій із них оголошено учасників, що зустрілися, — тож знахідка наводить вам кожну межу, оголошення якої могло б їх розділити, і не стверджує про жодну, що винна саме вона. З тієї ж причини знахідка повідомляється щодо документа Release загалом: назвати одну межу в ньому означало б відіслати вас до документа, який міг нічого не додати до цього шляху.

Якщо конфліктує більше одного шляху, знахідки надходять разом під звітом, що вказує їхню спільну рису:

assembled output paths written by more than one contributor (шляхи зібраного виводу, за якими записує більше одного учасника)

Як виправити: перейменуйте виведений файл у тій Recipe, яку ви контролюєте, — ключ artifacts:, ключ блоку boundary: або назву файлу, яку виводить трансляція Workload, — щоб вони більше не зустрічалися. Якщо дві Recipes оголошують один спільний файл і мають на увазі ту саму конфігурацію, зробіть їхні оголошення однаковими байт у байт. Якщо два учасники справді належать до окремих виводів, дайте їхнім межам різні шляхи directory:, щоб кожна збиралася окремо.

The same name is derived more than once inside the output (Одна й та сама назва виводиться у виводі більше одного разу)

В одній збірці та сама назва використовується двічі для чогось усередині файлів, які вона виводить, там, де є місце лише для одного. Так стається у два способи: два учасники виводять однакову назву або власний вивід одного учасника містить цю назву двічі. Це відрізняється від двох колізій вище: якщо задіяно двох учасників, компоненти мають різні назви, а їхні файли опиняються за різними шляхами, тож із формою збірки все гаразд, — ідеться про назву у вмісті, як-от ідентифікатор, яким ціль адресує один ресурс, або назву, під якою один вивід публікується, щоб на нього посилався інший.

Які назви порівнюються, випливає з того, що provider робить із виводом збірки. Якщо provider об’єднує цей вивід в один документ — один шаблон стека, один файл compose, — порівнюються між собою назви всередині цього одного документа, а учасник, вивід якого записується окремими власними файлами, стоїть поза ним. Його назви ні з чиїми не зустрічаються, тож між ними нічого не зупиняється, і жодне перейменування цього не змінило б. Якщо ж provider записує вивід кожного учасника власними файлами — рендер chart, набір маніфестів, — кожен учасник збірки порівнюється з кожним іншим, бо назва в такому виводі унікальна в межах усього, що читає ці файли як набір, а не в межах одного файлу.

Власні ресурси FeatureRecipe проходять тим самим шляхом, що й ресурси її компонента-хоста, бо приєднання додає свій внесок до збірки, якій належить хост. Тож якщо provider об’єднує, назви приєднання порівнюються з назвами компонента-хоста й кожного іншого приєднання точно так само, як назви двох компонентів: усі вони опиняються в одному документі, і одна з двох однакових назв там витісняє іншу. Якщо provider не об’єднує, ресурси приєднання записуються в каталог, названий за компонентом, до якого його приєднано, і його назви однаково порівнюються з кожним учасником збірки, — саме тут виявляється ідентичність ресурсу, яка має бути унікальною в усьому кластері. Отже, порівняння однакове в обох випадках, а відрізняється лише те, де опиняється назва, яку було б витіснено.

Одна половина цієї зупинки від усього цього не залежить: власний вивід одного учасника, що містить назву двічі. Це назва, використана двічі у виводі, записаному одним учасником, тож зупинка стається незалежно від того, куди записано цей вивід, і дві речі, які слід розділити, завжди перебувають усередині нього.

Більшість таких назв належать самому provider і виводяться з екземпляра компонента та ресурсу, тож два компоненти можуть дійти до однієї назви щоразу, коли збігаються частини, з яких її виведено, — і один компонент так само може двічі дійти до однієї назви, коли два його власні ресурси побудовано з частин, що збігаються. Оскільки назва міститься в байтах самого файлу, збірка її не бачить: provider повідомляє виведені ним назви, а збірка їх порівнює.

Один вид назв належить самій збірці, а не provider, і повідомляється так само: ідентичність, якою позначено кожен ресурс, що його виводить FeatureRecipe, і яка потрапляє у ваш вивід як мітка aggrega.ai/component-id. Про неї повідомляється під видом назви component-id, тож ви можете знайти той самий рядок у власному виведеному виводі. Якщо FeatureRecipe синтезує свої ресурси, вони також називаються за цією ідентичністю; якщо вона рендерить chart або фрагмент, наданий її автором, назви всередині цього рендеру лишаються назвами компонента-хоста, а ідентичність несуть лише мітки.

Для feature, приєднаної до компонента, вона складається з компонента, до якого приєднано feature, і ключа, який ви записали в features:, після фіксованого початку. Компонент-хост є частиною значення, бо одна назва feature, приєднана до кількох компонентів, виводить на кожному окремий набір ресурсів, і кожному набору потрібна власна ідентичність.

Для feature, приєднаної до межі, вона складається з назви feature і кожного сегмента шляху межі, після власного початку. В обох місцях значення складається, а не підставляється: символ, який алфавіт міток не приймає, записується в розгорнутому вигляді, а не замінюється, а частини з’єднуються послідовністю, якої не може містити жодна записана частина, тож два приєднання, які можна розрізнити, завжди дають дві ідентичності. Єдиний залишок — довжина: складена ідентичність, задовга для значення мітки, скорочується навколо дайджесту від усього значення, і дві скорочені ідентичності теоретично можуть збігтися. Ця зупинка повідомляє про такий збіг між двома учасниками, назви яких порівнюються, а два приєднання на одному компоненті є двома такими учасниками скрізь, де provider їхнього хоста збирає їх разом. Як будується кожна з них, див. у ../providers/well-known-annotations.md.

Рендер Kubernetes повідомляє власний вид назв: назву, яку кожен ресурс, створений його власним рендерингом, має в metadata.name. Така назва має бути унікальною в межах свого kind — а для виду, який кластер зберігає в просторах імен, ще й у межах свого простору імен, — а не в усьому виводі, тож вид назви вказує, до чого з цього її обмежено. Він починається з resource-names, а далі містить kind ресурсу та простір імен, у який потрапляє ресурс, — той, який ресурс називає для себе, або, якщо не називає жодного, той, яким анотовано межу. Отже, resource-names:Service--default — це назви Services, що потрапляють у default. Вид, який API Kubernetes зберігає поза будь-яким простором імен, — ClusterRole, StorageClass, CustomResourceDefinition, — а також власний вид, який CustomResourceDefinition у тому самому рендері оголошує з областю Cluster, містить лише свій kind, незалежно від того, який простір імен записано в його документі: resource-names:ClusterRole — це назви всіх ClusterRole, які містить вивід. Усе, крім літер і цифр, записується в розгорнутому вигляді, а не замінюється, і дві частини з’єднуються послідовністю, якої не може містити жодна записана частина, тож дві різні пари ніколи не дають один вид назви, а вид сам по собі ніколи не дає вид назви для пари виду й простору імен. Service і Deployment можуть мати спільну назву, а два простори імен незалежно містять одну назву виду з простором імен, тож жоден із цих випадків не зупиняє збірку. Сама назва повідомляється точно так, як її записав ваш chart, тож саме цей рядок слід шукати у ваших шаблонах.

Тож два учасники одного виводу, кожен з яких записує один об’єкт рівня кластера під однією назвою, зупиняють збірку, навіть якщо Release розміщує їх у двох просторах імен, бо застосування обох записує цей один об’єкт двічі; а один chart, що записує такий об’єкт у двох різних просторах імен, які рендер виводить як два файли, зупиняє збірку як один учасник, що містить назву двічі. Вид, який ніщо в рендері не класифікує, — власний вид, CustomResourceDefinition якого рендер не виводить, або документ, що не називає apiVersion, — порівнюється в межах свого простору імен, як вид із простором імен, бо ніщо в рендері не вказує, що кластер зберігає його поза простором імен; тому два учасники, що записують один такий об’єкт у двох просторах імен, не зустрічаються.

Назви порівнюються між учасниками одного виводу і ніколи — між двома виводами. Дві межі є двома виводами, коли кожна має власний каталог — той, який вона називає, або той, що надається кожній межі, яка не називає directory:, — і ніщо у збірці не вказує, чи застосовуються два виводи до одного кластера чи до двох: CustomResourceDefinition одного оператора, постачений у кожен із двох кластерів, — це одна назва у двох виводах, і це правильно. Тож дві межі, кожна з яких записує один об’єкт рівня кластера під однією назвою, збираються, навіть якщо обидві застосовуються до одного кластера; якщо так і є, виводьте цей об’єкт лише з однієї з них.

Найчастіше до цієї зупинки призводить така конфігурація: дві сутності Features, приєднані до одного компонента, кожна з яких постачає чарт, наданий її автором. Обидва чарти рендеряться з тим самим іменем релізу — іменем компонента-хоста, щоб приєднання чарту не перейменовувало ресурси, які його автор уже оголосив і розгорнув, — а називати ресурс за іменем релізу є однією з найпоширеніших речей, які робить чарт. Зі структурою виводу все гаразд: два ресурси просто мають одне ім’я. Якщо провайдер компонента записує окремі документи, кожне приєднання записує у власний каталог, і застосування обох залишає той, що був застосований останнім; якщо він згортає свою групу в один документ, обидва приєднання роблять внесок у цей документ, і одне з двох імен витісняє інше всередині нього. Перейменуйте ресурс у чарті, який ви контролюєте, або дайте йому ім’я з чимось, що розрізняє два приєднання, — і до шаблону має дійти саме приєднання, оскільки обидва чарти рендеряться з іменем релізу хоста, тож перейменування лише приєднання нічого не змінює. Передайте .attachment_name у чарт через valuesMapping: сутності FeatureRecipe і встановіть його в те зі значень чарту, з якого будуються імена його ресурсів.

Друга конфігурація призводить до тієї самої зупинки з однією сутністю Feature замість двох: чарт, шаблон якого записує ім’я ресурсу як літерал, приєднаний до двох компонентів. Кожен хост рендерить його під власним іменем релізу, тож літерал — єдина причина, через яку дві копії мають одне ім’я: назвіть ресурс за .Release.Name, і хост знову в ньому присутній — саме так уже чинить чарт, що будує імена своїх ресурсів з ідентичності свого релізу.

Третя конфігурація має ту саму форму, лише на одну поверхню авторингу глибше: FeatureRecipe, що постачає свої ресурси через artifacts:, а не через чарт, приєднаний під одним ім’ям до двох компонентів, тіло якого записує ім’я ресурсу як літерал. Вивід кожного приєднання потрапляє в каталог, названий за його хостом, тож емітовані шляхи різняться і зі структурою виводу все гаразд, — але обидва тіла мають те саме ім’я, і застосування обох залишає той, що був застосований останнім. Ім’я в тілі artifacts порівнюється точно так само, як ім’я, відрендерене чартом: обидва описують той самий ресурс у тому самому кластері, тож звідки взялося ім’я, не має значення для того, що станеться під час застосування обох. Таке тлумачення ґрунтується на тому, що два імені читаються разом, а це відбувається там, де провайдер записує вивід кожного учасника як файли, які ціль читає як один набір. Якщо ж провайдер зливає вивід збірки в один документ, файли кожного приєднання стоять поза цим документом, і ім’я в одному з них обмежене ним, тож два такі приєднання ніколи не зустрічаються, і збірка продовжується.

Звітується не кожне ім’я, тож збірка, яка не зупинилася, не встановила, що кожне ім’я, яке зрештою матиме її вивід, було порівняне. Ресурс, ім’я якому має дати кластер, — той, що оголошує generateName замість name, — ще не має імені, тож звітувати нічого. А ім’я, записане в якесь інше поле, щоб контролер прочитав його пізніше, не є іменем ресурсу, тож ніщо його не порівнює. Обидва обмеження є властивостями читання емітованого документа, тож обидва застосовуються до тіла artifacts точно так само, як і до відрендереного шаблону чарту.

Тіло artifacts: є шаблоном, тож ім’я в ньому, яке має бути різним для кожного хоста, складається, а не записується як літерал. .context.rendered_name — це ім’я, яке дає хост-компоненту його власний провайдер: за helm — ім’я його релізу, записане символами, дозволеними в імені Kubernetes, — а .attachment_name — це ключ, під яким ви його приєднали, тож {{ .context.rendered_name }}-{{ .attachment_name }} дає ресурсу власне ім’я на кожному хості й під кожним приєднанням. На хості, провайдер якого не звітує такого імені, складіть його натомість із .context.instance_id, ідентичності хоста. Одне написане тіло потрапляє до кожного хоста, до якого воно приєднане, з усіма іменами, що в ньому є, а літерал однаковий на всіх них, — тож надайте імені, яке має бути унікальним у кластері, саме таку форму.

Значення імені ніяк не інтерпретується — два звітовані імені або є тим самим текстом, або ні, — тому той самий звіт охоплює кожен вид імені, хто б його не вивів.

Ім’я може з’явитися в кількох звітах для одного компонента, оскільки кожна частина компонента звітується під час її рендерингу. Це один ресурс, названий у кожному звіті, до якого він належить, а не ім’я, використане двічі, і це не спричиняє зупинки. Зупинку спричиняє один звіт, що містить одне ім’я двічі, оскільки такий звіт описує вивід, де ім’я справді використано двічі.

Таке тлумачення залежить від того, що вважається одним учасником, і для виду component-id відповідь — приєднання, а не компонент чи межа, на якій воно розташоване. Приєднання ідентифікується обома координатами, які ви для нього написали, — компонентом, до якого його приєднано, разом із ключем під features:, або шляхом межі разом з іменем на цій межі, — тож два приєднання на одному компоненті є двома учасниками, так само як два на різних компонентах, а одне ім’я feature, записане на двох межах, є двома учасниками, хоча ім’я на кожній однакове. Те, що вони є двома учасниками, робить їхні ідентичності порівнюваними в кожній із цих конфігурацій; чи порівнюються двоє з них узагалі, визначається тим самим правилом, що й для кожного іншого імені тут, тож там, де провайдер зливає вивід, приєднання, вивід якого записується як окремі власні файли, стоїть поза злитим документом і порівнюється лише із самим собою. Отже, два приєднання, що дійшли до однієї ідентичності, спричиняють зупинку скрізь, де їхній вивід може досягти виводу одне одного, і кожна знахідка називає обидві свої координати, щоб ви могли визначити, які дві речі слід розділити. Оскільки обидві координати є частиною складеного значення, два приєднання, які можна розрізнити, доходять до двох ідентичностей за будь-якої довжини, що вміщується, — тож до цієї зупинки призводить конфігурація, у якій значення, задовге для своєї цілі, було скорочено і два скорочені значення зустрілися. Там, де дві скорочені ідентичності зустрічаються, а їхній вивід не може досягти виводу одне одного, — два приєднання на одному компоненті, за провайдера, що зливає вивід, кожне записане як окремі власні файли, — ніщо їх не порівнює, і два набори ресурсів мають один aggrega.ai/component-id на двох.

Одну конфігурацію варто назвати прямо, оскільки здається, що вона мала б спричинити зупинку, але не спричиняє: приєднання feature під тим самим ім’ям на двох компонентах повністю підтримується і не потребує перейменування. Компонент є частиною складеного значення, тож metrics на api і metrics на web доходять до двох ідентичностей, і ресурси кожного компонента отримують власну ідентичність, — це важливо, бо каскад, який за задумом створює одне ім’я приєднання для багатьох компонентів, не залишає автору іншого імені, яке можна написати. Кожен спосіб, у який FeatureRecipe постачає ресурси, ставить її ідентичність на те, що вона емітує, зокрема й той, що лише вендорить джерело і рендерить його як є, тож кожен із них порівнюється; feature, FeatureRecipe якої взагалі нічого не емітує, не має чого порівнювати.

Збірка зупиняється, а не залишає одне й відкидає інше. Правильного мовчазного розв’язання не існує: збереження першого повністю вилучило б із виводу оголошений вами ресурс і залишило б збірку зі звітом про успіх, а все, що посилалося на вилучений, непомітно розв’язалося б натомість до того, що залишився. Звітується кожне колізійне ім’я, кожне з видом імені, до якого воно належить, і з названим кожним учасником, що його вивів, — тож одна збірка показує всю картину, а не по одній колізії за раз. Учасник, власний вивід якого містить ім’я двічі, названий як такий, що вивів ім’я більше одного разу, і саме це вказує, що дві речі, які слід розділити, містяться всередині цього одного компонента, а не між двома.

Повідомлення, що виводяться. Для кожного учасника й кожного імені, що конфліктує, повідомляється одна знахідка, тож кожного учасника, який вивів це ім’я, названо окремо, а не згорнуто в список усередині одного повідомлення. Якщо ім’я вивели два учасники, знахідок щонайменше дві, і вони надходять разом під звітом, що вказує, що в них спільного:

dispatch groups whose contributors derive one name more than once in one key space (групи диспетчеризації, учасники яких виводять одне ім’я більше одного разу в одному просторі ключів)

Кожна знахідка називає ім’я, вид цього імені, учасника, який його вивів, а також провайдера й шлях збірки, у яку зливається їхній вивід:

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>") (колізія виведеного імені: одне ім’я виведено більше одного разу в одному просторі ключів (простір ключів, виведено компонентом, провайдер, шлях диспетчеризації))

Учасника названо відповідно до того, чим він є, і саме це вказує, де записано його ім’я: derived by component для екземпляра компонента та derived by feature для фічі, приєднаної до межі.

Якщо власне ім’я учасника саме по собі його не ідентифікує, далі йде друга координата, і яка саме — залежить від виду. Фіча, приєднана до межі, несе шлях межі, бо одне ім’я фічі може бути записане на кількох межах:

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>") (колізія виведеного імені: одне ім’я виведено більше одного разу в одному просторі ключів (простір ключів, виведено фічею, приєднано на межі, провайдер, шлях диспетчеризації))

Компонент несе ключ приєднання, рендеринг якого вивів це ім’я, бо компонент несе одне приєднання на кожен записаний вами ключ:

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>") (колізія виведеного імені: одне ім’я виведено більше одного разу в одному просторі ключів (простір ключів, виведено компонентом, що несе приєднання, провайдер, шлях диспетчеризації))

Власний рендеринг компонента — ім’я, яке його провайдер вивів для самого компонента, а не для одного з його приєднань, — не несе другої координати, тож знахідка закінчується на імені компонента.

Якщо власний вивід одного учасника містить ім’я двічі, цей учасник — єдина знахідка, тож вона надходить окремо, без звіту над нею, — і його названо таким, що вивів ім’я більше одного разу, а не таким, що зустрівся з іншим учасником:

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>") (колізія виведеного імені: одне ім’я виведено більше одного разу в одному просторі ключів (простір ключів, виведено більше одного разу компонентом, провайдер, шлях диспетчеризації))

Друга координата тут іде за учасником на тих самих умовах, що й вище, тож повтор усередині власного виводу одного приєднання називає це приєднання, а не лише компонент, що його несе.

Як виправити: якщо названо двох учасників, перейменуйте одного з них в Aggregate, щоб виведені з нього імена більше не збігалися з іменами іншого. Якщо вид імені — component-id, кожна знахідка вже називає те, що слід перейменувати: carrying attachment "…" — це ключ у блоці features: цього компонента, а feature "…" attached at boundary "…" — це ім’я в блоці features: цієї межі. Якщо дві знахідки відрізняються лише межею, яку вони називають, два приєднання мають одне ім’я на двох межах — перейменуйте одне з них або задайте двом межам різні шляхи directory:, щоб їхній вивід більше не зливався. Якщо обидва імені склала збірка, вони могли зустрітися лише після скорочення під ціль, тож скоротіть частини, з яких вони складаються, самостійно, а не залишайте це збірці. Якщо обидва імені виведено з чогось, що ви задали явно, — значення, яке Recipe передає провайдеру, або анотації, яку читає провайдер, — змініть натомість це в тому з двох, який контролюєте ви. Якщо два учасники справді належать до окремих виводів, задайте їхнім межам різні шляхи directory:, щоб кожен збирався окремо й ці два імені ніколи не зустрічалися. Якщо одного учасника названо таким, що вивів ім’я більше одного разу, обидві конфліктні речі містяться в цьому одному компоненті: знайдіть два ресурси, які створює його Recipe і чиї імена збігаються, і змініть те, за чим названо один із них, — ключ, під яким його оголошено, або значення, з якого його побудовано, — щоб провайдер вивів для кожного окреме ім’я. Якщо вид імені — це сам по собі вид рівня кластера, як-от resource-names:ClusterRole, названі документи описують один об’єкт у кластері, хоч би в які простори імен їх розміщено: виводьте його лише від одного учасника — через значення, яке пропонує його чарт, наприклад перемикач встановлення його визначень, — або, якщо це мають бути два об’єкти, дайте одному з них власне ім’я в чарті чи тілі, яке ви контролюєте; один учасник, названий для нього двічі, записує його в двох просторах імен, і один із двох документів слід відкинути.

An authored export name is one the build derives for a cross-stack reference (Написане автором ім’я експорту збігається з тим, яке збірка виводить для міжстекового посилання)

Блок Outputs: сутності Recipe типу cloudformation — це написаний автором CloudFormation, і запис у ньому може мати власний Export: із Name:; це ім’я потрапляє до зібраного стека точно так, як його написано. Окремо, коли ребро uses переходить з однієї межі до іншої, провайдер публікує спожите значення як Output стека з Export під іменем, яке він виводить із релізу, межі, компонента та наданого ключа. Ця зупинка спрацьовує там, де вони зустрічаються: написане вами ім’я збігається з тим, яке виведення створило для тієї ж збірки, тож стек оголосив би одне ім’я експорту двічі з двох місць, а ім’я експорту має бути унікальним.

Зупиняє лише збіг. Оголошення імені експорту в записі Outputs підтримується, і ім’я, що не збігається з жодним виведеним, публікується поряд із виведеними без зауважень — у кожному записі, крім виходу стека, на якому міжстекове посилання публікує власний експорт для ключа, який воно споживає. Export: там зупиняє збірку, якщо не містить точно виведене ім’я; цей випадок описано в The output a cross-stack reference publishes on already carries an Export (Вихід, на якому міжстекове посилання публікує експорт, уже містить Export).

Зупинка наводить виведене ім’я експорту разом із чотирма частинами, з яких його побудовано, щоб ви бачили, яке міжмежове посилання його створило, і називає вихід стека, під яким стоїть ваше оголошення, — позначений як ім’я, яке збирає провайдер, а не яке написала сутність Recipe, бо провайдер будує це ім’я, кодуючи компонент і запис у літери та цифри, допустимі для логічного ID, тож воно не збігається з рядком, яким було написано будь-що з них. Шукати слід саме ім’я експорту. Ваш запис пише його точно так, як зупинка, саме це й робить їх колізією, тож це єдиний рядок, який з’являється і в повідомленні, і у ваших файлах.

Порівняння обмежене одним стеком: імена експорту, які оголошує цей стек, порівнюються з іменами, виведеними для міжмежових посилань, що публікують у нього. Два стеки між собою не порівнюються, а ім’я експорту, написане як вбудована функція CloudFormation, розв’язується під час розгортання, тож порівнювати немає з чим. Із чим ім’я зустрічається серед експортів, уже розгорнутих в обліковому записі та регіоні, — це властивість розгортання, якої збірка не спостерігає.

Повідомлення, що виводиться. Умова називає вид збою, а власне речення провайдера каже, що сталося; навколишній звіт також називає ребро uses, яке з’єднується:

two things a plugin produced occupy one name in its output (дві речі, створені плагіном, займають одне ім’я в його виході) 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 (ім’я експорту, яке виводить міжмежовий зв’язок, уже оголошене іншим записом Outputs у тому ж стеку: зв’язок виводить ім’я експорту для ключа provides компонента в межі сутності Release, а інший запис Outputs того ж стека вже оголошує це ім’я експорту — це оголошення стоїть під виходом стека, ім’ям, яке збирає цей провайдер, а не написала сутність Recipe; кожен затінювальний запис Outputs пише ім’я експорту точно так, як зупинка, тож пошук цього імені у ваших Recipes знаходить запис — перейменуйте ім’я експорту, яке оголошує запис, або видаліть блок Export цього запису й дозвольте зв’язку опублікувати експорт)

Як виправити: знайдіть у своїх Recipes ім’я експорту, яке називає зупинка, — запис Outputs, що його оголошує, пише його ідентично, — потім або перейменуйте це ім’я експорту, щоб воно більше не збігалося, або видаліть блок Export: цього запису й дозвольте міжстековому з’єднанню опублікувати експорт самостійно. Видалення зазвичай доречне там, де запис існував для експорту того самого значення, яке споживає ребро: провайдер усе одно публікує Export для цього значення, тож написаний автором нічого не додає. Залиште написаний Export: і перейменуйте його, якщо запис експортує значення для іншого споживача, який імпортує його під обраним вами іменем.

The output a cross-stack reference publishes on already carries an Export (Вихід, на якому міжстекове посилання публікує експорт, уже містить Export)

Коли ребро uses переходить з однієї межі до іншої, провайдер публікує Export спожитого значення на виході стека, який він збирає для компонента-виробника та наданого ключа, — тому самому виході, до якого доходить сутність Recipe типу cloudformation, коли її блок Outputs: пише запис під цим ключем. Export:, що вже є на цьому виході, зберігається лише тоді, коли його Name: точно збігається з іменем, яке виводить провайдер: це експорт, який уже опублікувало попереднє міжстекове посилання на те саме значення, тож кожен споживач імпортує одне ім’я. Будь-який інший Export: там зупиняє збірку, бо запис експорту провайдера перезаписав би написане вами, а збереження вашого змусило б кожного споживача імпортувати ім’я, якого посилання ніколи не публікувало.

Зупинка спрацьовує на чотирьох формах Export: на цьому виході:

  • Name:, що є іншим рядком;
  • Name:, написаний як вбудована функція CloudFormation, яка розв’язується під час розгортання, тож провайдер не може прочитати, що вона містить;
  • блок Export:, який нічого не називає;
  • Export:, написаний як просте значення, а не як блок.

Ім’я експорту, яке ви оголошуєте в будь-якому іншому записі Outputs, порівнюється окремо, у An authored export name is one the build derives for a cross-stack reference (Написане автором ім’я експорту збігається з тим, яке збірка виводить для міжстекового посилання).

Повідомлення, що виводиться. Умова називає вид збою, а власне речення провайдера каже, що сталося; навколишній звіт також називає ребро uses, яке з’єднується:

two things a plugin produced occupy one name in its output (дві речі, створені плагіном, займають одне ім’я в його виході) 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 (вихід стека, на якому міжмежовий зв’язок публікує свій експорт, уже містить Export, якого зв’язок не писав: зв’язок виводить ім’я експорту для ключа provides компонента в межі сутності Release, а вихід стека, який цей провайдер збирає для цього ключа й компонента, містить знайдене; видаліть блок Export цього запису й дозвольте зв’язку опублікувати експорт, який імпортує кожен споживач)

<what-it-found> — одне з наведеного, у порядку форм вище:

already declares the export name <name> (уже оголошує ім’я експорту) 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 (уже оголошує ім’я експорту, що не є рядком, — задане як вбудована функція, яка розв’язується під час розгортання, тож цей провайдер не може прочитати, що вона містить) already carries an Export block declaring no export name (уже містить блок Export, що не оголошує імені експорту) already carries an Export that is not a block, where CloudFormation expects one carrying a Name (уже містить Export, що не є блоком, тоді як CloudFormation очікує блок із Name)

Як виправити: у сутності Recipe компонента, який називає зупинка, знайдіть запис Outputs, написаний під наданим ключем, який вона називає, і видаліть блок Export: цього запису — тоді міжстекове з’єднання опублікує експорт, який імпортує кожен споживач. Якщо вам також потрібно експортувати значення під власним іменем для споживача поза цією збіркою, напишіть цей Export: у записі Outputs під іншим ключем: ім’я експорту там підтримується, якщо воно не є одним із тих, які виводить збірка.

Chart-name mismatch on a merged helm-chart umbrella (Невідповідність назви чарту в об’єднаному парасольковому чарті helm-chart)

Дві або більше меж роблять внесок в один шлях збирання провайдера helm-chart, але їхні ефективні анотації aggrega.ai/chart-name (визначені через каскад анотацій меж) не збігаються. Парасольковий чарт Helm має рівно одну назву чарту; рендерер не може вибрати одного з конфліктних кандидатів.

Повідомлення, що виводяться. Для кожної межі, що робить внесок, повідомляється окрема знахідка, яка містить значення, до якого визначилася ця межа, тож розбіжні назви надходять по одній на знахідку, а не однією виведеною колекцією. Звіт, у межах якого вони надходять, зазначає, що в них спільного:

merged dispatch groups whose boundaries disagree on the assembly name (об’єднані групи диспетчеризації, межі яких не погоджуються щодо назви збирання)

Кожна знахідка називає значення, до якого визначилася ця межа, анотацію, з якої його прочитано, межу, провайдера та шлях, до якого вони об’єднуються:

merged-path assembly has conflicting assembly-name annotation values ("<value>", annotation "<annotation>", boundary "<boundary>", provider "<provider>", dispatch path "<path>") (збирання об’єднаного шляху має конфліктні значення анотації назви збирання (значення, анотація, межа, провайдер, шлях диспетчеризації))

Як виправити: оголосіть однакову анотацію aggrega.ai/chart-name на кожній межі, що робить внесок (механізм каскаду дає змогу уникнути повторення, коли учасники мають спільну батьківську межу, — оголосіть її один раз на батьківській), або рознесіть межі по окремих шляхах directory:, щоб кожна отримала власний парасольковий чарт.

FeatureRecipe template references a field outside its scope’s allowlist (Шаблон FeatureRecipe посилається на поле поза дозволеним списком своєї області)

FeatureRecipe з executionScope: boundary посилається на поле, доступне лише для окремого компонента, як-от .context.instance_id, .context.inject або .context.uses, — поля, що не мають змістовного значення в області межі, — у шаблоні, який виконується один раз для межі: у своїх locals:, provides:, valuesMapping:, artifacts: або в with: чи when: кроку конвеєра. Діє й дзеркальна умова: FeatureRecipe з областю компонента (типовою), що посилається на поля .boundary.*, не проходить той самий валідатор. Перевірка виконується під час розбору щодо дозволеного списку полів відповідної області, до початку будь-якого рендерингу. injectMapping у FeatureRecipe з областю межі тут не перевіряється: він виконується один раз для кожного компонента, до якого доходить прикріплення, у контексті цього компонента, тож читає .context.*, а посилання на .boundary у ньому повідомляється в розділі «Template references a root the render context does not define (Шаблон посилається на корінь, якого не визначає контекст рендерингу)» вище.

Повідомлення, що виводиться:

FeatureRecipe template references a per-component-only field with executionScope: boundary ("<dotted-path>", written in "<field>", the render context defines "<the roots the boundary-scope context defines>") (шаблон FeatureRecipe посилається на поле лише для окремого компонента з executionScope: boundary)

FeatureRecipe з областю межі, чий valuesMapping читає .context.instance_id, виводить:

[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")

Як виправити: перепишіть шаблон із використанням полів, доступних у цій області, або змініть executionScope сутності FeatureRecipe. Сутності FeatureRecipes з областю boundary посилаються на .boundary.path, .boundary.boundary_name, .boundary.components, колекції .boundary.*_uses_edges, .boundary.labels, .boundary.annotations і .boundary.feature_attachments. Сутності FeatureRecipes з областю Component посилаються на .context.instance_id, .context.inject, .context.uses, .context.labels, .context.annotations. Обом областям спільні .values, .infra, .locals, .provides, .steps і .metadata. Параметр сутності Release не є окремою опорою на цій поверхні — він потрапляє до шаблону FeatureRecipe через запис values або infra, який на нього посилається.

Self-inject value template references cross-node data (Шаблон значення самоін’єкції посилається на дані інших вузлів)

Шаблон value: у inject: рівня компонента бере дані з .context.inject або .context.uses. Канал ін’єкції — це саме те, що будує цей прохід, тож шаблон усередині власного значення самоін’єкції компонента не може з нього читати.

Причина в .context цієї поверхні: він містить instance_id, labels і annotations і нічого більше. Отже, .context.inject і .context.uses — ключі, яких контекст цієї поверхні не визначає, і посилання зупиняє збирання як «Template references a root the render context does not define» вище, під час розбору, до будь-якого рендерингу. Діагностика називає механізм і ключ доставки, до яких належить шаблон, і перелічує ключі, які .context тут визначає, — тож той самий звіт охоплює і справжню спробу дістатися даних інших вузлів, і звичайну описку, як-от {{ .context.nmae }}, що трапляється частіше й інакше відрендерилася б як ніщо.

Повідомлення, що виводиться, — деталь рівня посилання; звіт навколо нього також називає вузол, механізм і ключ доставки:

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) (шаблон посилається на корінь, який контекст рендерингу не визначає)

Кожен кадр звіту належить до домену розробника, оскільки блок inject: рівня компонента пишеться в сутності Aggregate.

Як виправити: перенесіть зв’язування між компонентами в запис uses[].inject — саме там доступний контекст інших вузлів. Обмежуйте шаблони value: самоін’єкції рівня компонента власними values і infra компонента, його .context.instance_id / .context.labels / .context.annotations та .metadata.

Відсутній ключ шаблону — асиметрична політика

Обробка відсутнього ключа залежить від поверхні шаблону. Там, де порожній результат потрапляє в обмежене місце — поле маніфесту, яке автор може перечитати, — пропуск допускається, і читання не дає нічого. Там, де порожній результат натомість створив би хибну структуру або хибний вердикт, поверхня відхиляє посилання, а не розв’язує його в ніщо.

  • Інтерполяція параметрів в Aggregate — посилання {{ .parameters.<key> }}, які містить власний текст Aggregate, — найраніша з цих поверхонь: вона виконується над сирим документом до розв’язання каталогу, тож її політика застосовується до тексту, якого ще не бачила жодна інша поверхня. Посилання на параметр, який Release так і не заповнив, не дає нічого, а конвеєр default або умова if над таким читанням поводяться так само, як над незаповненим параметром. Посилання, яке шаблон перебирає, перебирається як ніщо, що й потрібно для обходу необов’язкового списку, — хіба що текст також його виводить: тоді збірка зупиняється, як описано нижче в «A template reads and iterates a path that holds nothing (Шаблон читає і перебирає шлях, у якому нічого немає)». Посилання, батьківський елемент якого відсутній, — .parameters.db.host, коли параметр db не заповнено, — все одно зупиняє збірку, бо немає куди заглиблюватися, а підставлення батьківського елемента обміняло б зупинку на непомітно хибний артефакт. Одну межу варто назвати саме межею, а не політикою: посилання, прив’язане до кореня, якого поверхня не визначає, залишається без змін, а не перетворюється на ніщо, тож воно потрапляє в інтерпольований документ як власний текст-заповнювач рушія шаблонів, <no value>. На цій поверхні ніщо на ньому не зупиняється, тому прив’язуйте кожне посилання на параметр до .parameters, а випадковий <no value> сприймайте як помилково написаний корінь.
  • Шаблони шляхів (directory: / subDirectory: межі в Release) обчислюються з missingkey=error. Посилання на змінну, якої поверхня їм не надає, зупиняє збірку під час розбору — див. «Path-template references a variable outside the allowlist (Шаблон шляху посилається на змінну поза списком дозволених)» вище, — так само як і хибно написаний ключ під .manifest, ключі якого оголошено. Дозволене, але не визначене під час обчислення посилання, наприклад ключ .parameters, якого Release не надає, дає явну помилку, а не непомітно вставляє порожній рядок у шлях каталогу.
  • assertions (у сутностях Component, Feature, Recipe або FeatureRecipe) обчислюються з missingkey=error. Посилання на невизначений ключ зупиняє збірку з діагностикою про відсутній ключ, що називає сутність, екземпляр і твердження. Саме ця суворість робить твердження надійним: предикат, посилання якого дало б порожнє значення, порівнювався б із нічим і проходив би, тож одна друкарська помилка непомітно скасувала б правило, для забезпечення якого твердження написано. Оскільки голе посилання зупиняє збірку раніше, ніж може спрацювати будь-який запасний варіант, звичайний default не дає запасного значення для необов’язкового поля на цій поверхні — обмежте посилання за допомогою hasKey або скористайтеся помічником optional, який виконує перевірку наявності безпосередньо. Читання ключа через index теж його не дає: index зупиняє збірку на ключі, якого немає в мапі, називаючи цей ключ.
  • Шаблони значень (valuesMapping у Recipe, записи locals: і provides:, тіла artifacts:, тіла Workload, injectMapping і pipeline.with у FeatureRecipe та шаблони value: самоін’єкції на рівні компонента) обчислюються з missingkey=zero, тож посилання на невизначений ключ не зупиняє збірку — читання не дає нічого, і саме ніщо потрапляє в артефакт. Що на цій поверхні все ж зупиняє збірку, — це посилання, яке заглиблюється крізь контейнер, якого автор так і не надав, — .values.tls.ca, коли tls не задано, — бо немає куди заглиблюватися. Як ніщо відображається лише останній ключ посилання, усі контейнери якого наявні. Поле верхнього рівня, яке контекст визначає, але в якому нічого немає, — .workload у сутності Recipe, яка нічого не синтезує, .features у компонента без приєднань, — так само відображається як ніщо, коли його читають цілком. Одне посилання — це одне посилання, хоч як його написано: .values.list, $.values.list і (.values).list називають той самий ключ, тож перебір в одному написанні — це перебір у всіх, а ключ, прочитаний зі стовпа в дужках, відображається або зупиняє збірку точно так само, як пряме написання. Ключ, який шаблон перебирає, перебирається як ніщо, коли його не задано, а ключ, який шаблон і виводить, і перебирає, зупиняє збірку, коли його не задано, — див. «A template reads and iterates a path that holds nothing (Шаблон читає і перебирає шлях, у якому нічого немає)» нижче. Захисні конструкції працюють як очікується: {{ .values.optional_field | default "fallback" }} справді підставляє запасне значення, бо незадане значення вважається порожнім для default і хибним для if. Автори, яким потрібно розрізняти відсутність і нуль — відрізняти «ключ відсутній» від «ключ наявний і порожній», — використовують помічник optional, описаний у templates/sprig-functions.md, і читають кожен ключ лише одним способом у межах шаблону: ключ, який той самий шаблон також читає як .values.<key>, вважається наявним, тож optional повертає його порожнє значення, а не запасне. Ця політика не охоплює читання через index: індексування мапи ключем, якого в ній немає, зупиняє збірку з назвою ключа тут, як і на кожній поверхні, — див. «A template indexes a map with a key the map does not hold (Шаблон індексує мапу ключем, якого в ній немає)» нижче.
  • Координата source: — шаблонні поля структурованого блоку source: у Recipe або FeatureRecipe (version, ref, chart, module_subdir) — обчислюється з missingkey=error. Посилання на ключ, якого ніщо не надає, зупиняє збірку з назвою поля джерела, а не розв’язується в ніщо: порожня версія чи ref закріпили б інший артефакт, ніж той, що назвав автор, а закріплення — це те, що відтворює кожна наступна збірка. Ця поверхня також відрізняється доступним набором функцій, і на ній посилання locals:, яке відхиляє порядок самого блоку, заданий автором, зупиняє збірку раніше, ніж щось обчислюється, — див. нижче.
  • Типізовані контракти параметрів перехоплюють випадки відсутнього обов’язкового параметра й порушення контракту на рівні контракту параметрів, ще до виконання інтерполяції, — див. «Parameter type mismatch / contract violation (Невідповідність типу параметра / порушення контракту)» вище.

Набір помічників однаковий для шаблонів значень, шаблонів шляхів і тверджень: функції Sprig плюс власні функції Aggrega (optional і capitalizedWords). Серед них є fail із Sprig, тож шаблон значення може зупинити збірку власним повідомленням, як описано нижче в розділі «A value template failed while it ran (Шаблон значення зазнав помилки під час виконання)»; твердження — поверхня, написана саме для цього, бо зупинка збірки — уся його мета. Між цими трьома відрізняється лише політика відсутніх ключів — optional доступний і в шаблоні шляху, де він читає ключ із .parameters раніше, ніж спрацює сувора політика. Розв’язання координати source: відрізняється самим набором функцій і має окремий підрозділ нижче. Інтерполяція параметрів в Aggregate пропонує лише функції Sprig, тож жоден помічник Aggrega там не доступний. Одна функція читає однаково на кожній із цих поверхонь, включно з координатою та інтерполяцією: index, яка зупиняє збірку з назвою ключа, коли мапа, яку вона читає, його не містить.

Повідомлення, яке виводить пропуск у шаблоні шляху, наведено в записі, що описує цю умову, — «Path-template references a variable outside the allowlist (Шаблон шляху посилається на змінну поза списком дозволених)» вище, — тож воно записане один раз і тут не повторюється.

Як виправити: для пропусків у шаблонах шляхів виправте назву поля на одну зі списку дозволених, описаного в path-template-variables.md. Для пропуску у твердженні виправте посилання — здебільшого це помилково написаний ключ — або, якщо поле справді необов’язкове, обмежте його за допомогою hasKey чи скористайтеся помічником optional; обгортання голого посилання в default не усуне зупинку, бо посилання розв’язується раніше, ніж спрацює запасний варіант, і читання через index теж не усуне, бо index зупиняє збірку на ключі, якого немає в мапі. Для пропусків у шаблонах значень, де порожній результат небажаний, скористайтеся помічником optional або надайте відсутній ключ як типізоване оголошення parameters.* в Aggregate зі значенням у Release, як запис provides: вищого за потоком Component, підключений через uses[].inject, або як запис locals: у тій самій сутності.

Resolving a source: coordinate registers a narrower function set (Розв’язання координати source реєструє вужчий набір функцій)

Структурований блок source: розв’язується для того, щоб закріпити артефакт, який він називає, і це розв’язання реєструє власні допоміжні функції Aggrega і нічого іншого: доступні optional і capitalizedWords, а index зупиняє збірку на ключі, якого немає в мапі, так само, як під час рендерингу сутності Recipe; функції Sprig недоступні. Серед поверхонь, на яких Recipe або FeatureRecipe записує шаблони, лише ця має інший набір функцій, тож вираз, який коректно рендериться деінде в тому самому Recipe, тут може бути відхилено. Вужчий набір обрано свідомо: те, що закріплюється, визначають значення та infra, які надає автор, а серед функцій Sprig є такі, що читають годинник, оточення, джерело випадковості або мережу.

Виклик функції Sprig у полі source: або в записі locals:, який це поле читає, зупиняє збірку на етапі розбору. Діагностика має заголовок E0111 і називає запис, поле source:, яке його читає, функцію, яку не вдалося розв’язати, і допоміжні функції, які ця поверхня реєструє:

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 (розв’язання: розбір шаблону в записі locals, який читає поле source: помилка розбору шаблону source (причина: функцію не визначено); поле source і кожен запис locals, який воно читає, обчислюються під час розв’язання source лише з власними допоміжними функціями Aggrega (optional, capitalizedWords та index), без функцій Sprig, які додає рендеринг; запишіть значення без цієї функції або перенесіть значення в запис locals, який не читає жодне поле source)

Поле source:, яке саме викликає функцію, повідомляється так само, але називається лише поле.

Охоплення — це записи, які читає координата. Розв’язання координати обчислює кожен запис locals:, який читає поле source:, і кожен запис, який своєю чергою читає такий запис, — і жодних інших. Запис, до якого не доходить жодне поле source:, не обчислюється, не розбирається і не перевіряється під час розв’язання source, тож локальне значення, потрібне рендерингу, — яке виконує арифметику функціями Sprig або називає ресурс за .context.instance_id, — не впливає на закріплення артефакту; його обчислюють, і будь-яку помилку в ньому повідомляють, під час рендерингу Recipe. Які записи читає поле, визначається з його тексту, тож для поля, що читає .locals так, що не називає жодного окремого запису, — {{ index .locals "version" }}, увесь блок, переданий у optional або прив’язаний до змінної, — обчислюються натомість усі записи, і діагностика для запису, досягнутого так, про це каже: замість read by <field> у ній написано evaluated for <field>, which reads the locals block as a whole rather than by entry, so every entry is evaluated.

Дві форми лежать поза цією поверхнею, і знання того, у якій із них перебуває Recipe, пояснює, чому той самий вираз приймається в одному Recipe і відхиляється в іншому:

  • source:, записаний як звичайний рядок, — URI або локальний шлях, а не мапа, — береться дослівно, тож у ньому немає полів для обчислення, і блок locals: тут узагалі не розв’язується.
  • Сутність, яка не оголошує source:, не розв’язує жодної координати, тож її блок locals: розв’язується лише для власного рендерингу цієї сутності, де діє повний набір функцій.

Контракт порядку посилань тут той самий для кожного запису, який читає координата. Розв’язання координати відхиляє ті самі посилання, що й рендеринг, у кожному записі, який воно обчислює: запис, що читає сусідній запис, оголошений у блоці нижче, і будь-який шаблон, що читає ключ, якого блок не оголошує. Обидва випадки повідомляють умови, описані вище в розділах «locals: entry references a sibling defined later in the same block» і «locals: key does not exist», — ту саму умову з тим самим способом виправлення, яке б розв’язання не дійшло до неї першим, — і повідомлення називає поле source:, для якого обчислювався запис. Помилку в записі, який не читає жодне поле source:, відхиляють під час рендерингу Recipe за тією самою умовою.

Ця поверхня пропускає лише запис, який координата справді не може розв’язати: такий, що читає дані, які існують лише під час рендерингу артефакту, — саме для випадку .context.instance_id. Такий запис пропускається, тож Recipe, координата якого доходить до нього в гілці, що не виконується, все одно закріплюється. Якщо ж координаті сам цей запис був потрібен, розв’язання зупиняється з назвою поля source: — це повідомлення про відсутній ключ, описане для цієї поверхні вище, з заголовком E0110, — і поруч із ключем, який не вдалося прочитати, наводить, чому цей запис тут не має значення:

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") (розв’язання: обчислення шаблону в полі source: збій обчислення шаблону source під час блокування (причина: у мапі немає запису для ключа); поле читає запис locals, який тут не вдалося обчислити (причина: у мапі немає запису для ключа context))

Ні поле source:, ні запис locals:, який воно читає, не можуть читати .provides. Блок locals: живить блок provides: і ніколи навпаки, тож шаблон на цій поверхні, що читає .provides, відхиляється як зворотне посилання, яким він і є, а не розв’язується в порожнє значення. Ця відмова — не відсутність під час блокування, яку задовольнила б пізніша фаза: жоден порядок не робить посилання дійсним, тож воно повідомляється однаково, де б не розв’язувалася координата. Діагностика має заголовок E0112; вона називає поле або запис і поле, що його читає, каже, що не так із посиланням, і вказує поверхню, яку вираз може читати натомість:

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) (шаблон версії source у полі посилається на provides, що є недійсним зворотним посиланням (locals живлять provides, ніколи навпаки) — переробіть, щоб читати лише values та infra (і locals над ними): розв’язання: шаблон source посилається на provides (недійсне зворотне посилання))

Де виникає зупинка: під час заповнення або оновлення lock-файлу — aggrega pull або збірка, яка його заповнює (--auto-pull, --upgrade чи налаштування робочого простору auto_pull). Кожен збій повідомляється однією діагностикою з заголовком — кодом того, що пішло не так: E0111 для шаблону, який не розбирається, E0112 для посилання на .provides, E0110 для шаблону, який розібрано, але не вдалося обчислити, — однаково в терміналі та в редакторі, під’єднаному до aggrega serve. Відсутній ключ у полі source:, на відміну від недоступної функції, повідомляється під час виконання, а не розбору, з назвою поля та ключа, який не вдалося прочитати.

Як виправити: optional зареєстровано на цій поверхні і в кожному шаблоні значень, шаблоні шляху та твердженні, тож це переносний вибір: {{ optional .values "chart_version" "25.0.8" }} замість {{ default "25.0.8" .values.chart_version }}. Перед заміною зважте на семантичну різницю: optional спрацьовує, коли ключ відсутній, а default — коли значення порожнє, тож ключ, записаний як порожній рядок або нуль, зберігає записане значення з optional і замінюється з default. Якщо виразу справді потрібна функція Sprig — для перетворення рядка, а не для запасного значення, — винесіть її за межі того, що читає координата: у запис locals:, який не читає жодне поле source:, або на поверхню, яка його споживає (valuesMapping, тіло Workload, запис artifacts:).

A template indexes a map with a key the map does not hold (Шаблон індексує мапу ключем, якого мапа не містить)

Шаблон читає мапу через index — {{ index .values "replicas" }} або {{ index .context.inject.env $apiKeyVar }} з іменем ключа, яке обчислив шаблон, — а мапа не містить запитаного ключа. index зупиняється на цьому й називає ключ на кожній поверхні, що обчислює шаблон: у шаблонах значень, записах locals: і provides:, шаблонах шляхів, твердженнях, структурованій координаті source:, інтерполяції параметрів в Aggregate та предикатах validate: його параметрів, а також у предикатах x-aggrega-when: і x-aggrega-validate: схеми.

Це властивість лише index, і політика відсутніх ключів жодної поверхні її не змінює. Читання через крапку невстановленого ключа у відкритому стовпі, як і раніше, нічого не виводить у шаблоні значення, як описано вище в розділі «Missing template key — asymmetric policy (Відсутній ключ шаблону — асиметрична політика)», а шаблон, що перевіряє, чи автор надав такий ключ, це не зачіпає. Зупинка відбувається, коли в index запитують ключ, якого мапа не містить. index — це спосіб, яким шаблон дістається ключа, ім’я якого він обчислює, — наприклад, облікових даних, прочитаних під іменем змінної, яке вибрав споживчий Recipe, — і без зупинки таке читання вставило б у артефакт текст-заповнювач шаблонізатора <no value>, а збірка завершилася б успішно: сервер запустився б із цим текстом як ключем. Усі інші відповіді index — це відповіді самого шаблонізатора: позиція у списку чи рядку, позиція поза діапазоном, ключ, який мапа містить, — зокрема той, значення якого null, що виводить <no value>.

Повідомлення, що виводиться, як останній рядок звіту — фрейми над ним називають вузол і поле, у якому розташований шаблон, а в шаблоні значення Recipe або FeatureRecipe заголовок містить код цієї умови:

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 (шаблон: виконання за адресою: помилка виклику index: шаблон індексує мапу ключем, якого мапа не містить (ключ). читайте ключ, який може бути відсутнім, через функцію, що спершу перевіряє його наявність, як-от optional, get або hasKey)

На поверхні, яка повідомляє про збій шаблону під власною умовою, — запис provides: («A provides: template could not be evaluated (Шаблон provides не вдалося обчислити)»), інтерполяція параметрів («A {{ .parameters.* }} reference cannot be interpolated (Посилання не можна інтерполювати)»), предикат схеми («An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (Предикат не можна обчислити)»), координата source: («Resolving a source: coordinate registers a narrower function set (Розв’язання координати source реєструє вужчий набір функцій)») — заголовок містить код тієї умови, а рядок вище є причиною, яку вона містить, разом із ключем.

Як виправити: вирішіть, чи може ключ законно бути відсутнім.

  • Може. Читайте його через функцію, що спершу перевіряє його наявність: {{ optional .values "replicas" 1 }} повертає запасне значення, коли ключ відсутній, і значення, яким би воно не було, коли ключ присутній; get зі Sprig повертає порожній рядок для відсутнього ключа; hasKey перевіряє без читання. optional зареєстровано на кожній поверхні, крім інтерполяції параметрів і предикатів параметра чи схеми, які пропонують get і hasKey зі Sprig; координата source: реєструє optional, але не Sprig.
  • Не може. Надайте його. Ключ, який називає повідомлення, — це ключ, який запитав шаблон, тож зазвичай причини такі: ключ опубліковано під іншим іменем — облікові дані, чий key не збігається з іменем змінної, яке читає Recipe, — помилка в написанні ключа в шаблоні чи в авторських значеннях, або з’єднання, яке доставило б ключ, не під’єднано.

A template reads and iterates a path that holds nothing (Шаблон читає й ітерує шлях, який нічого не містить)

Шаблон виводить шлях як є і водночас ітерує той самий шлях — скажімо, "user": "{{ .values.user }}" і "users": "{{ range .values.user }}…{{ end }}" в одному valuesMapping, — а дані там нічого не містять: ключ не задано, він містить null або це поле верхнього рівня, яке контекст визначає, але для якого нічого не містить, як-от .workload у сутності Recipe, що не синтезує жодного робочого навантаження. Збирання зупиняється до виконання шаблону й називає шлях — на кожній поверхні, яка рендерить незадане значення як ніщо: у шаблонах значень, перелічених вище в розділі «Missing template key — asymmetric policy (Відсутній ключ шаблону — асиметрична політика)», і в інтерполяції параметрів у сутності Aggregate.

Кожне читання саме по собі має відповідь. Незадане значення, яке виводиться, рендериться як ніщо, а те, яке ітерується, не дає жодної ітерації. Шлях, прочитаний обома способами, не може мати жодної з цих відповідей: рендеринг його як нічого змусив би range зазнати збою на тексті, а залишення його незаданим вивело б в артефакт текст-заповнювач шаблонізатора <no value>, тоді як збирання завершилося б успішно. Тож жодної відповіді не дається, і натомість збирання зупиняється.

Те, що вважається виведенням шляху, визначено вузько, і межу проведено там, де шаблон напевно його виводить:

  • Шлях виводиться, коли дія складається зі шляху й нічого іншого — {{ .values.user }}, {{ $.values.user }}, {{ (.values).user }} або змінна, прив’язана до шляху, {{ $u }} після {{ $u := .values.user }}, — у точці, якої шаблон досягає щоразу під час виконання.
  • Шлях не виводиться, коли читання розташоване в тілі if, with або range чи в гілці else, бо те, чи виконається це читання, залежить від умови, а умова може бути саме тією перевіркою, яка не дає йому натрапити на ніщо, — тому {{ if .values.user }}{{ .values.user }}{{ end }} поряд із range .values.user рендериться так само, як завжди. Не виводиться він і тоді, коли читання є власною перевіркою охоронної умови, присвоєнням змінній або аргументом функції — {{ .values.user | quote }}, {{ toYaml .values.user }}, — результатом якої є відповідь функції, а не заповнювач.

Виведення шляху, що нічого не містить, усередині тіла, яке таки виконується, однаково записує <no value>, і ця перевірка цього не охоплює. Один запис шляху — це той самий шлях, що й будь-який інший, тож виведення в одному записі та range в іншому оцінюються разом, а повідомлення цитує запис, який шаблон використав першим. Шлях, що містить значення, виводиться й ітерується, як завжди, а шлях, батьківський елемент якого нічого не містить, залишається для зупинки, яку вже спричиняє спуск крізь ніщо.

Повідомлення, що виводиться, як останній рядок звіту — фрейми над ним називають вузол і шаблон, а заголовок містить код цієї умови:

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 (Шаблон читає шлях як значення й ітерує його, а дані за цим шляхом нічого не містять. Задайте значення за цим шляхом, захистіть виведене читання за допомогою if або with над цим шляхом або читайте його лише одним способом)

Інтерполяція параметрів у сутності Aggregate також повідомляє той самий рядок під кодом цієї умови. Запис provides: повідомляє про збій шаблону в розділі «A provides: template could not be evaluated (Шаблон не вдалося обчислити)», тож там заголовок містить код тієї умови, а рядок вище — це причина, яку він містить, включно зі шляхом.

Як виправити: визначте, яке з двох читань має на увазі шаблон.

  • Шлях має бути. Задайте його — у values: сутності Aggregate, в infra: сутності Release або в параметрі, який заповнює сутність Release, — або оголосіть його обов’язковим у схемі, що ним керує, щоб про його відсутність повідомлялося там, де його задають.
  • Шлях може бути відсутнім. Захистіть виведене читання: {{ with .values.user }}{{ . }}{{ end }} або {{ if .values.user }}{{ .values.user }}{{ end }} нічого не виводить, коли шлях не задано, а range поряд і далі ітерує як по нічому.
  • Достатньо одного читання. Читайте шлях одним способом — через range, який також записує те, що йому потрібно, або виведенням через функцію, як-от toYaml чи join, яка сама дає відповідь для незаданого значення.

A value template failed while it ran (Шаблон значення зазнав помилки під час виконання)

Шаблон значення сутності Recipe або FeatureRecipe — один із шаблонів, які перелічує розділ «Missing template key — asymmetric policy (Відсутній ключ шаблону — асиметрична політика)» вище, зокрема тіло Workload, тіло artifacts: або запис locals:, — було розібрано, він почав виконуватися й зупинився, не створивши тексту. Зупинила його власна причина шаблонізатора, яку зупинка несе під собою: посилання, що спускається крізь контейнер, якого ніщо не надало, наприклад {{ .values.tls.ca }}, коли tls не записано; порівняння значень двох типів, наприклад {{ if eq .context.instance_id 1 }}, яке порівнює текст із числом і зупиняється з cannot compare text with a number; або виклик fail зі Sprig, який шаблон значення може зробити, щоб відхилити вхідні дані власним повідомленням.

Чотири види помилок у цих шаблонах натомість повідомляються під власними умовами. Запис provides: повідомляється в розділі «A provides: template could not be evaluated (Шаблон не вдалося обчислити)» нижче, з цим реченням і причиною шаблонізатора всередині свого повідомлення. Читання через index ключа, якого мапа не містить, повідомляється в розділі «A template indexes a map with a key the map does not hold (Шаблон звертається до мапи за ключем, якого вона не містить)» вище. Шаблон, який виводить та ітерує один шлях, що нічого не містить, відхиляється до виконання, і про це повідомляється в розділі «A template reads and iterates a path that holds nothing (Шаблон читає й ітерує шлях, який нічого не містить)» вище. А шаблон, який не розбирається, зупиняється до виконання, тож це не ця умова.

Повідомлення, що виводиться, — фрейми над ним називають екземпляр компонента й шаблон, наприклад recipe "<recipe>" workload template або Recipe "<recipe>" locals["<key>"], а власний рядок шаблонізатора йде під ним:

a value template failed while it ran (шаблон значення зазнав помилки під час виконання)

Рядок шаблонізатора має вигляд template: <template>:<line>:<column>: executing "<template>" at <<expression>>: <reason> — для виклику fail це error calling fail: <the message the template wrote>. Збірка повідомляє про зупинку з тегом CATALOG_ERROR, бо шаблон пише автор сутності Recipe або FeatureRecipe. aggrega pull стикається з тією самою помилкою, коли рендерить сутність Release, щоб виявити зовнішні вхідні дані, які вона читає: він повідомляє про помилку, усе одно записує закріплення залежностей у lock-файл і повідомляє, що закріплення зовнішніх вхідних даних можуть бути неповними; збірка на цьому зупиняється.

Як виправити: прочитайте причину шаблонізатора в кінці звіту — вона називає шаблон, рядок і стовпець, а також вираз, на якому він зупинився. Для контейнера, якого ніщо не надало, надайте його або захистіть читання, щоб воно ніколи не спускалося в щось відсутнє: {{ with .values.tls }}{{ .ca }}{{ end }} або помічник optional. Якщо порівнюються два типи, порівнюйте однорідне — число з числом, записаним без лапок, текст із текстом, записаним у лапках, — або перетворіть одну сторону на текст за допомогою toString. Для виклику fail повідомлення належить авторові шаблону й каже, що потрібно сутності Recipe: надайте це або зіставте компонент із сутністю Recipe, яка приймає те, що ви написали.

A governance plugin rejected the build (Плагін управління відхилив збірку)

Оператор може під’єднати плагін управління в ролі вердикту — над графом, який побудував компілятор, або над артефактами, які він відрендерив. Такий плагін читає й повертає вердикт. Хост не має шляху, яким міг би застосувати зміну, що повертається від нього, тож роль вердикту може відхилити збірку, але не може переписати її до відповідності вимогам — відхилення є всім, що вона може зробити, а що змінити, вирішує той, хто його читає.

Зупиняє збірку лише вердикт halt. Про вердикти warn та info повідомляється, і збірка триває. Повідомляється про кожен вердикт halt, який повернув плагін, у порядку, в якому плагін їх видав, тож один запуск розповідає вам про всі.

Повідомлення, яке виводить збірка, належить самому плагіну: воно подається точно так, як його повернуто, і обрамлене лише назвою плагіна, що його повернув, — тож наскільки воно конкретне й корисне для дій, вирішує плагін, а не компілятор. Будь-які необов’язкові деталі, які містив вердикт, ідуть далі у квадратних дужках, кожна частина з назвою: код, ідентифікатор правила, класифікація, посилання на джерело, розташування, пропозиція. Умова, під якою це записується, — policy violation, і саме до неї зводиться короткий код у заголовку діагностики.

Відмова приписується під’єднанню управління, а не одному з ваших документів, тож вона не містить позиції у файлі: немає ключа, що її спричинив, і відповідь полягає або в тому, щоб задовольнити політику, або в тому, щоб переглянути під’єднання.

Повідомлення, що виводиться:

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>] (плагін політики відхилив збірку)

Частина у квадратних дужках присутня лише тоді, коли вердикт містив деталі, а кожна її частина — лише тоді, коли плагін її задав.

Як виправити: прочитайте повідомлення плагіна і пропозицію, якщо він її надав. Якщо зауваження слушне, змініть те, проти чого воно заперечує. Якщо політика не повинна застосовуватися до цієї сутності Release, це питання під’єднання: під’єднання управління налаштовуються в plugins.governance у конфігурації робочого простору, а який плагін працює в якій ролі — рішення оператора, а не те, що документ може перевизначити.

A governance attachment’s settings do not match the plugin’s declared schema (Налаштування під’єднання управління не відповідають оголошеній схемі плагіна)

Плагін управління може оголосити схему для налаштувань, які передає йому під’єднання. Налаштування, записані в with.settings під’єднання, перевіряються за цією схемою до виклику плагіна, тож неправильно налаштоване під’єднання повідомляється як помилка конфігурації, якою воно є, а не потрапляє до плагіна як вхідні дані хибної форми й не повертається як те, що плагін із ними зробить.

Саме в такому порядку й полягає сенс перевірки. Він також чітко відрізняє цю умову від відхилення: плагін не запускався, вердикту не досягнуто, і нічого в збірці не оцінювалося. Плагін, що не оголошує схеми налаштувань, приймає будь-які налаштування, тож під’єднання до такого плагіна з цим ніколи не стикається.

Перевірка охоплює кожну роль управління. Під’єднання, задане в ролі ir-verdict, render-verdict, label-transform або annotation-transform, має налаштування, перевірені за схемою до виклику плагіна, — with.settings є тим самим авторським ключем у кожній ролі, і кожна роль спершу звіряє його зі схемою. Роль перетворення виконується там, де збірка її застосовує, а у збірці, яка спершу виконує pull, — під час цього pull, тож повідомлення там починається з кроку, який її викликав, як у auto-pull: label-transform:.

Повідомлення, що виводиться, — роль, у якій задано під’єднання, і плагін, який воно називає, потім фіксоване речення, потім те, що виявила перевірка схеми:

ir-verdict: plugin "<the attachment's uri>": with.settings does not satisfy the plugin’s declared settings schema: <what the schema check found>: policy attachment settings do not satisfy the plugin’s declared settings schema (ir-verdict: плагін: with.settings не задовольняє оголошену схему налаштувань плагіна: налаштування під’єднання політики не задовольняють оголошену схему налаштувань плагіна)

Для під’єднання, заданого в ролі render-verdict, початкова частина містить саме цю назву. Те, що виявила перевірка схеми, — це власний звіт валідатора схеми, і він займає більше одного рядка.

Як виправити: виправте налаштування в with.settings цього під’єднання в plugins.governance. Деталі в середині повідомлення називають помилковий ключ і те, що схема там очікувала; власна довідка плагіна документує налаштування, які він оголошує.

A pipeline step failed (Крок конвеєра завершився помилкою)

FeatureRecipe може оголосити конвеєр: послідовність кроків, кожен з яких викликає експорт плагіна над документами, що їх вивів вузол, щоб Feature міг формувати вивід, створений власною сутністю Recipe компонента. Це умова, під якою крок повідомляє про збій з будь-якої причини, окрім патча, що адресує те, чого немає в наборі документів, — для цього нижче є окреме повідомлення.

Те, що зазнало збою, називається за ідентифікатором кроку та його індексом, а наступна частина речення вказує, що саме не вдалося: рендеринг вхідних даних кроку with, сам виклик, вивід, який хост не зміг прочитати, помилка, яку повернув плагін, діагностика рівня помилки, яку видав плагін, патч, відхилений рушієм патчів, або патч, що називає область, якої немає в обході.

Крок, що зазнав збою, відкочується повністю. Документи відновлюються до стану перед виконанням кроку, а власні виводи кроку відкидаються разом з ними, тож when або with пізнішого кроку не може прочитати частковий результат. Крок, оголошений як optional: true, тоді повідомляє про попередження, і обхід триває; крок, що не є необов’язковим, зупиняє збірку. Чого optional: не допускає, то це порушення оголошеного контракту — див. запис нижче.

Повідомлення, що виводяться:

pipeline step failed: step "<id>" (index <n>) with: <what the render could not do> pipeline step failed: step "<id>" (index <n>) invoke: <what the call could not do> pipeline step failed: step "<id>" (index <n>) error diagnostic: <the plugin's message> pipeline step failed: scope "<scope>" key "<key>": <what the patch engine refused> pipeline step failed: unknown patch scope "<scope>"

Як виправити: прочитайте ідентифікатор кроку, а потім частину після індексу — вона вказує, на яку половину кроку дивитися. Збій with — це шаблон у власному блоці with: кроку, і виправити його маєте ви. Діагностика помилки — це власні слова плагіна про ваші вхідні дані. Відхилений патч і невідома область — це вивід плагіна щодо того, що вивів вузол, і відповідає за них автор плагіна. Якщо кроку справді дозволено зазнати збою — необов’язкове збагачення, а не обов’язкове перетворення, — оголосіть його як optional: true, пам’ятаючи, що це допускає збій, але не порушений контракт.

A pipeline step’s typed input or output does not satisfy its declared contract (Типізований вхід або вихід кроку конвеєра не відповідає оголошеному контракту)

Експорт плагіна може оголосити схему для вхідних даних, які він приймає, і для виводів, які повертає. Перевіряються обидва: відрендерене значення with перед викликом і повернені виводи після нього. Діагностика, рівень серйозності якої спільний контракт не оголошує, відхиляється на тих самих підставах.

Це зупиняє збірку навіть для кроку, оголошеного як optional: true, і саме ця відмінність пояснює, чому умова відокремлена від збою кроку. Необов’язковість допускає крок, який не зміг виконати свою роботу, — виклик, що зазнав збою, плагін, що заперечив. Вона не допускає виводу, який хост не може маршрутизувати, або вхідних даних, які ніколи не мали форми, заявленої експортом: оголошений контракт — це зобов’язання, і збірка, яка непомітно пропустила крок із порушеним контрактом, повідомляла б про успіх щодо Feature, що нічого не зробив.

Повідомлення, що виводяться:

pipeline step "<id>" with input does not satisfy the declared input contract: <what the schema check found>: pipeline step typed-I/O contract violation pipeline step "<id>" returned outputs that do not satisfy the declared output contract: <what the schema check found>: pipeline step typed-I/O contract violation

а для рівня серйозності діагностики, який контракт не оголошує, — повідомлення надходить у рамці збою кроку:

pipeline step failed: step "<id>" (index <n>): <the severity the host could not route>: pipeline step typed-I/O contract violation

Якщо шаблон with кроку читає значення, оголошене чутливим, порушення вхідних даних не називає жодного значення. Знайдене перевіркою схеми замінюється кожною позицією, що не пройшла, і ключовим словом, яке її відхилило, а завершується приміткою з причиною — at '/origin': pattern (the value is withheld because the template that rendered this input reads a value declared sensitive), — тож поле, яке слід виправити, усе одно названо. Див. vocabulary/compact-form-authoring.md «Що відмова каже про оголошене значення».

Як виправити: у разі порушення вхідних даних виправте блок with: кроку відповідно до схеми, яку оголошує його експорт, — подробиці називають поле й очікуване. Порушення виводу та неоголошений рівень серйозності виправляє плагін; помилка не в оголошенні кроку, тож позначення його необов’язковим не усуне жодного з них.

A pipeline patch addresses a document the set does not hold, or one with no tree to address (Патч конвеєра адресує документ, якого немає в наборі, або документ без дерева для адресування)

Крок конвеєра адресує документ за областю та ключем, і дві форми адреси відхиляються.

Набір його не містить. Крок застосував патч до пари «область–ключ», якої немає серед переданих йому документів. Нічого не було б змінено, тож замість застосувати патч до порожнечі й повідомити про успіх обхід зупиняється:

pipeline patch targets a document not present in the set: scope "<scope>" key "<key>"

Він не має дерева для адресування. Деякі одиниці не мають структури, на яку може вказати патч, — двійкове тіло, вільний текст, ділянка, яку провайдер не може безпечно обійти. Така одиниця все одно передається кроку з позначкою її медіатипу та байтами, щоб її можна було вибрати й вивести цілком; до неї не можна лише застосувати патч, бо шляху немає відносно чого розв’язуватися. Патч проти неї зупиняє обхід, а не пропускається непомітно:

pipeline patch targets an opaque (non-structured) unit: scope "<scope>" key "<key>"

Що вважається структурованим, визначає власне прочитання одиниці провайдером, а не фіксована перевірка, тож той самий вміст може бути адресованим в одного провайдера й непрозорим в іншого.

Обидві — це власні відмови обходу, і збірка повідомляє про них щодо вузла, конвеєр якого застосував патч, тож наведене вище повідомлення надходить під зупинкою, що називає цей вузол. Ця зупинка — форма тих самих двох помилок адресування, що зупиняє збірку, описана нижче в розділі «A pipeline step addresses documents the node does not have» (Крок конвеєра адресує документи, яких вузол не має), — який охоплює й третю адресу, за якою крок нічого не досягає: запит документів компонента-хоста в місці, що не стоїть проти жодного.

Як виправити: обидві помилки стосуються автора плагіна, а не вас. Крок отримує набір документів, над яким його виконують, і може прочитати, які ключі в ньому є, тож відсутня ціль означає, що крок адресує документ, якого цей вузол не виводив, — застосуйте патч до наявного документа або спершу виведіть потрібний і застосуйте до нього патч на пізнішому кроці. Для непрозорої одиниці замініть патч виведенням усієї одиниці: непрозоре тіло замінюється, а не редагується.

A patch’s test operation did not match the document (Перевірна операція патча не збіглася з документом)

Патч може містити операцію test, яка стверджує, що міститься за певним шляхом, перш ніж буде застосовано наступні за нею операції. Рушій відхиляє весь патч, коли твердження не справджується, і саме це робить умовний патч умовним, а не оптимістичним: плагін, який перевіряє перед редагуванням, тим самим каже, що не торкатиметься документа, якого не розпізнає.

Під цією умовою повідомляються два випадки. За шляхом немає нічого взагалі, про що й каже повідомлення. Або значення є, але не те, що стверджувалося, і тоді повідомляється лише сама відмова — ні стверджуване, ні знайдене значення не цитуються.

Повідомлення, що виводяться:

jsonpatch: test operation failed: no value at path (jsonpatch: операція test не вдалася: за шляхом немає значення) jsonpatch: test operation failed (jsonpatch: операція test не вдалася)

Якщо патч містився у виводі кроку конвеєра, відмова надходить під збоєм цього кроку з його назвою. Якщо патч надійшов від плагіна перетворення міток, відмова надходить під відмовою патча міток.

Як виправити: помилка на боці плагіна, а не ваших документів. Перевірка, що очікувала значення, якого документ не має, зазвичай означає, що плагін працює зі структурою, для якої його не писали, — з виводом іншого провайдера або з документом, який уже змінив попередній крок того самого конвеєра. Якщо патч виправляти вам, або послабте перевірку до того, що документ справді містить, або зробіть так, щоб умова when кроку пропускала цей випадок, замість перевіряти його всередині патча.

A workload: form and the fields beside it do not agree (Форма робочого навантаження і поля поруч із нею не узгоджуються)

workload: оголошує form: — форму того, що запускається, виражену в термінах, зрозумілих кожній цілі, а не словником якоїсь однієї цілі. Деякі поля мають сенс лише для однієї форми, а форма, оголошена без потрібного їй поля, не має нічого узгодженого для рендерингу. Перевіряються обидва напрямки, ще до того як будь-яка ціль перекладе робоче навантаження, тож розбіжність повідомляється один раз щодо написаного вами, а не окремо для кожної цілі її власними словами.

Перевіряються п’ять пар, і кожна повідомляє власне речення, що називає обидві половини та що слід написати:

workload declares a persistentTemplate volume but is not form: stateful; declare form: stateful (робоче навантаження оголошує том persistentTemplate, але не має form: stateful; оголосіть form: stateful) workload is form: reference but declares no endpoint; set endpoint to the external host or URL the reference points at (робоче навантаження має form: reference, але не оголошує endpoint; задайте endpoint як зовнішній хост або URL, на який вказує посилання) workload declares an endpoint but is not form: reference; declare form: reference or remove the endpoint (робоче навантаження оголошує endpoint, але не має form: reference; оголосіть form: reference або видаліть endpoint) workload is form: scheduled but declares no schedule; set schedule to a 5-field cron expression or an @-macro (e.g. @daily) (робоче навантаження має form: scheduled, але не оголошує schedule; задайте schedule як cron-вираз із 5 полів або @-макрос, напр. @daily) workload declares a schedule but is not form: scheduled; declare form: scheduled or remove the schedule (робоче навантаження оголошує schedule, але не має form: scheduled; оголосіть form: scheduled або видаліть schedule)

Кожне прив’язане до екземпляра компонента, робоче навантаження якого зчитувалося, і повідомляється як помилка перекладу, бо розбіжність виникає між двома полями одного написаного блоку.

Умови, під якими вони записуються і до яких зводяться їхні короткі коди: persistentTemplate volume requires form: stateful, form: reference requires an endpoint, endpoint requires form: reference, form: scheduled requires a schedule і schedule requires form: scheduled.

Одна пара діє лише в один бік. Робоче навантаження form: stateful без шаблону заявки для кожної репліки — звичайна річ і нічого не викликає: правило полягає в тому, що шаблону заявки потрібна стабільна ідентичність кожної репліки, яку дає лише ця форма, а не в тому, що формі потрібен шаблон заявки. Дві інші пари діють в обидва боки, бо endpoint і schedule мають сенс кожен лише для однієї форми.

Обидві пари з endpoint є і в схемі Workload, тож workload, що порушує будь-яку з них, відхиляється на етапі схеми, під E0214, раніше, ніж дійде до свого речення вище. endpoint: у будь-якій формі, крім reference, — включно з пропущеним form:, бо він читається як stateless, — відхиляється як

workload validation failed (Workload in Recipe <name>:<version>, at <path>, schema stage): .endpoint: value matches a shape that is not allowed here (перевірка workload не пройшла на етапі схеми: значення endpoint відповідає формі, яка тут не дозволена)

а form: reference без endpoint: натомість закінчується на .endpoint: missing required property: endpoint. Спосіб виправлення — той, що дає речення цієї пари.

Як виправити: кожне речення називає обидва поля і дає обидві відповіді. Додайте поле, потрібне формі, або змініть форму на ту, якій належить поле, або видаліть поле, що залишилося після редагування, — видалене значення schedule: із залишеним ключем є найпоширенішим випадком.

A workload schedule: is not an expression the check accepts (Розклад робочого навантаження не є виразом, який приймає перевірка)

Робоче навантаження form: scheduled містить schedule:, що вказує, коли воно запускається, і структура значення перевіряється до того, як його прочитає будь-яка ціль. Приймаються два записи: один із п’яти макросів @hourly, @daily, @weekly, @monthly і @yearly або crontab-вираз із п’яти полів, у яких використовуються лише цифри та символи *, ,, - і /.

Що перевірка читає і чого не читає. Вона рахує поля і дивиться на символи в них. Вона не обчислює діапазони, арифметику кроків чи назви днів тижня, тож п’ятипольовий вираз із числами поза діапазоном тут проходить, і відхиляти його — справа цілі. Шестипольовий вираз із початковим полем секунд відхиляється: ця поверхня приймає п’ять полів, а ціль, якій потрібні секунди, отримує їх в інший спосіб.

Повідомлення, що виводиться:

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 робочого навантаження не є дійсним cron-виразом; використайте crontab-вираз із 5 полів, напр. «0 0 * * *», або один із @hourly, @daily, @weekly, @monthly, @yearly)

Умова, під якою це записується, — schedule is not a valid cron expression, і саме до неї зводиться короткий код.

Як виправити: спершу порахуйте поля — розклад із чотирма або шістьма полями є найпоширенішою причиною, а зайвий пробіл усередині поля розбиває його на два. Замініть назву дня чи місяця її номером і скористайтеся макросом там, де він виражає те, що ви мали на увазі.

A workload suspend: is set on a form other than scheduled (Поле призупинення workload задано у формі, відмінній від запланованої)

suspend: true призупиняє повторюваний розклад workload із form: scheduled: запланований ресурс рендериться, але жоден запуск за його розкладом не почнеться, доки його не буде відновлено. Жодна інша форма не має розкладу, тож у будь-якій іншій формі полю нічого призупиняти, і збірка зупиняється, а не рендерить workload, який мовчки його відкидає. Перевірка виконується разом з іншими перевірками пар форм, до того як будь-яка ціль транслює workload, і пропущений form: тут також читається як stateless.

Повідомлення, що виводиться:

workload declares suspend but is not form: scheduled; declare form: scheduled with a schedule or remove suspend (workload оголошує suspend, але не є form: scheduled; оголосіть form: scheduled із розкладом або вилучіть suspend)

Знахідку прив’язано до екземпляра компонента, workload якого читався, і її повідомляється як помилку трансляції. Умова, під якою її записано, — suspend requires form: scheduled; саме в неї розв’язується її короткий код.

Правило діє лише в один бік і лише для true. Workload із form: scheduled без suspend: — звичайний випадок і виконується за своїм розкладом, а suspend: false, типове значення, у жодній формі нічого не спричиняє.

Як виправити: якщо workload мав запускатися лише тоді, коли хтось його запускає, зробіть його form: scheduled із schedule: і залиште suspend: true; інакше залиште форму як є і вилучіть suspend:, яке не читає жодна інша форма.

Бібліотечний $import: записано не у формі простого імені

Три поля сутностей Recipe і FeatureRecipe можуть брати свій вміст із бібліотеки замість того, щоб записувати його на місці: запис artifacts.<name>:, valuesMapping: і workload:. Кожне з них записує $import: із простим іменем бібліотеки, далі #, далі шлях до запису на поверхні, яку читає це поле, — відповідно #/artifacts/, #/mappings/ і #/workloads/. Значення, яке не має такої форми, не називає нічого, що збірка може розв’язати, і відхиляється під час розв’язання поля.

Три поля навмисно є дзеркальними відображеннями одне одного, тож помилка читається однаково для всіх трьох і змінюється лише поверхня:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): "<the value as written>" (artifacts $import: не є посиланням на бібліотеку артефактів за простим іменем) valuesMapping $import: is not a bare-name mapping-library reference (#/mappings/): "<the value as written>" (valuesMapping $import: не є посиланням на бібліотеку відображень за простим іменем) workload $import: is not a bare-name workload-library reference (#/workloads/): "<the value as written>" (workload $import: не є посиланням на бібліотеку навантажень за простим іменем)

Про версію, записану з @, повідомляється разом із написанням, яке слід використати натомість, а не загальною скаргою, що бібліотеку не знайдено, бо це найпоширеніша помилка в цій формі:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): version separator is ’:’, not ’@’ — use "<the corrected value>" (artifacts $import: не є посиланням на бібліотеку артефактів за простим іменем: роздільником версії є ’:’, а не ’@’ — використайте виправлене значення)

Тут повідомляється ще про одну форму, і це не помилка написання. Вміст власного файлу пакета ArtifactLibrary не може сам бути $import: іншого пакета: один слот файлу не може розгорнутися в багато файлів, тому вкладений імпорт відхиляється, а не розв’язується в щось, чого автор не писав. Натомість компонуйте пакети там, де їх споживають.

Запис artifacts:, який пише власна сутність Recipe компонента, визначається до будь-якого рендерингу, тож повідомлення прив’язане до блоку artifacts: у цій сутності Recipe і називає посилання, пакет, файл, вміст якого містить вкладений імпорт, і запис, у якому імпорт записано. Про кожен файл пакета з такою формою повідомляється в одній збірці; якщо таких більше одного, результати групуються під 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: не є посиланням на бібліотеку артефактів за простим іменем. Вміст файлу пакета не може імпортувати інший пакет — компонуйте їх у записі artifacts, який їх споживає)

Запис artifacts:, який пише сутність FeatureRecipe, повідомляє про ту саму умову під час розв’язання пакета, називаючи перший файл із такою формою:

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: не є посиланням на бібліотеку артефактів за простим іменем: вміст файлу пакета є $import: на рівні кореня поля; вкладений бібліотечний імпорт у файлі пакета не підтримується, компонуйте в місці споживання)

valuesMapping:, який пише власна сутність Recipe компонента, визначається до будь-якого рендерингу, тож повідомлення прив’язане до ключа valuesMapping: у цій сутності Recipe і містить написання, яке слід використати:

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: не є посиланням на бібліотеку відображень за простим іменем. Назвіть бібліотеку й запис по обидва боки фрагмента)

valuesMapping:, який пише сутність FeatureRecipe, повідомляє під час розв’язання посилання у формі, наведеній у списку вище.

workload:, який пише власна сутність Recipe компонента, визначається до будь-якого рендерингу, тож повідомлення прив’язане до ключа workload: у цій сутності Recipe і містить написання, яке слід використати:

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: не є посиланням на бібліотеку навантажень за простим іменем. Назвіть бібліотеку й запис по обидва боки фрагмента)

workload:, який пише сутність FeatureRecipe, повідомляє під час розв’язання посилання у формі, наведеній у списку вище.

Як виправити: перепишіть значення як <Library>#<entry-path>, додаючи :<version> після імені бібліотеки лише тоді, коли потрібна нижня межа версії, яку можна вибрати. Перевірте, що фрагмент відповідає полю: шлях запису #/mappings/… у workload: називає поверхню, яку це поле не читає, і про це повідомляється тут, а не як про відсутній запис. Та сама форма ідентичності керує $ref: схеми, відмови якого описано вище в розділі «A $ref: is not written in a form the compiler can resolve ($ref: записано не у формі, яку компілятор може розв’язати)».

Бібліотечний $import: називає бібліотеку або запис, яких немає в каталозі

$import: записано правильно, але того, на що він вказує, немає. Шість умов охоплюють дві половини посилання для трьох видів бібліотек, і те, яку з них ви отримали, підказує, яку половину перевіряти: або самої бібліотеки немає серед того, що бачить збірка, або бібліотека є, але не публікує цей запис.

Набір, у якому розв’язується посилання, — це власний каталог робочого простору плюс бібліотеки, які lock-файл закріпив і які було підтягнуто під час завантаження збірки. Тож бібліотека, від якої ніщо в замиканні залежностей сутності Release не оголошує залежності, не входить до цього набору, хоч би яким правильним було посилання на неї.

Бібліотеки немає:

artifact-library import references an ArtifactLibrary not present in the catalog: ArtifactLibrary "<library>" (bundle "<entry>") (імпорт artifact-library посилається на ArtifactLibrary, якої немає в каталозі: ArtifactLibrary, bundle) mapping-library import references a MappingLibrary not present in the catalog: MappingLibrary "<library>" (entry "<entry>") (імпорт mapping-library посилається на MappingLibrary, якої немає в каталозі: MappingLibrary, запис) workload-library import references a WorkloadLibrary not present in the catalog: WorkloadLibrary "<library>" (entry "<entry>") (імпорт workload-library посилається на WorkloadLibrary, якої немає в каталозі: WorkloadLibrary, запис)

Запису немає:

artifact-library import references a bundle not present in the ArtifactLibrary: bundle "<entry>" in ArtifactLibrary "<library>" (імпорт artifact-library посилається на bundle, якого немає в ArtifactLibrary: bundle в ArtifactLibrary) mapping-library import references an entry not present in the MappingLibrary: entry "<entry>" in MappingLibrary "<library>" (імпорт mapping-library посилається на запис, якого немає в MappingLibrary: запис у MappingLibrary) workload-library import references an entry not present in the WorkloadLibrary: entry "<entry>" in WorkloadLibrary "<library>" (імпорт workload-library посилається на запис, якого немає в WorkloadLibrary: запис у WorkloadLibrary)

Запис artifacts:, який пише власний Recipe компонента, повідомляє про відсутній bundle у власній формі. Цей запис визначається до будь-якого рендерингу, тож повідомлення прив’язане до блоку artifacts: у цьому Recipe і, крім обох половин посилання, називає запис, у якому було написано імпорт:

artifact-library import references a bundle not present in the ArtifactLibrary ("<entry>", ArtifactLibrary "<library>", artifacts entry "<key>") (імпорт artifact-library посилається на bundle, якого немає в ArtifactLibrary)

valuesMapping:, який пише власний Recipe компонента, повідомляє про відсутній запис у власній формі з тієї самої причини: він теж визначається до будь-якого рендерингу, тож повідомлення прив’язане до ключа valuesMapping: у цьому Recipe і називає обидві половини посилання:

mapping-library import references an entry not present in the MappingLibrary ("<entry>", MappingLibrary "<library>") (імпорт mapping-library посилається на запис, якого немає в MappingLibrary)

workload:, який пише власний Recipe компонента, повідомляє про відсутній запис у власній формі з тієї самої причини: він теж визначається до будь-якого рендерингу, тож повідомлення прив’язане до ключа workload: у цьому Recipe і називає обидві половини посилання:

workload-library import references an entry not present in the WorkloadLibrary ("<entry>", WorkloadLibrary "<library>") (імпорт workload-library посилається на запис, якого немає в WorkloadLibrary)

Запис artifacts:, який пише FeatureRecipe, valuesMapping: або workload:, які пише FeatureRecipe, а також кожне посилання на бібліотеку, якої збірка не бачить, повідомляють про помилку під час розв’язання посилання у формах, наведених у двох списках вище.

Кожне повідомлення називає і бібліотеку, і запис, незалежно від того, яка половина не спрацювала, тож одного повідомлення досить, щоб відрізнити відсутню бібліотеку від відсутнього запису, нічого не відкриваючи.

Як виправити: для відсутнього запису звірте назву з тим, що публікує бібліотека, — назва запису є ключем у власній мапі цієї бібліотеки і чутлива до регістру. Для відсутньої бібліотеки посилання зазвичай правильне, а неповним є замикання: оголосіть залежність від цієї бібліотеки, щоб її було завантажено, і оновіть lock-файл, щоб її було закріплено. Бібліотека, доступна в одному робочому просторі й недоступна в іншому, — це та сама помилка, побачена з іншого боку.

Бібліотечний $import: адресує свою бібліотеку за розташуванням у реєстрі

Бібліотечний $import: називає свою бібліотеку за ідентичністю, а не за реєстром, у якому її випадково опубліковано. Через який реєстр розв’язується назва, визначає конфігурація робочого простору, а яку версію використано — lock-файл, тож посилання з хостом фіксує в документі каталогу дві речі, які має вирішувати збірка, — і документ перестає працювати в будь-якому робочому просторі з іншою конфігурацією.

Випадків, коли таке посилання ще може дійти до цієї зупинки, менше, ніж здається. Власні поля $import: у Recipe та FeatureRecipe відхиляються раніше — їхньою схемою, яка не допускає префікса реєстру в жодній із трьох позицій. Залишається посилання, якого не описує жодна схема: прочитане з власного тіла запису бібліотеки, якого сутність-споживач не писала й не може побачити, доки тіло не розв’язано.

Повідомлення, що виводиться з поверхонь valuesMapping: і workload:, де резолвер повідомляє лише значення:

library $import: carries a registry host; reference the library by bare-name identity: "<the value as written>" (бібліотечний $import: містить хост реєстру; посилайтеся на бібліотеку за ідентичністю у формі простої назви)

Запис artifacts: до цієї зупинки не доходить, і причину варто знати, якщо ви шукаєте її там. Його власне посилання відхиляється разом з рештою документа, як і в будь-якій іншій позиції; а на відміну від двох інших поверхонь, файл bundle, тіло якого саме є імпортом, відхиляється, а не розгортається, — тож немає тіла, з якого могло б надійти посилання з хостом.

Як виправити: приберіть хост і все, що стоїть перед назвою бібліотеки, залишивши <Library>#<entry-path>. Якщо хибне значення міститься в бібліотеці, яку ви споживаєте, а не публікуєте, виправлення має внести автор цієї бібліотеки; доки його не внесено, збірку розблоковує імпорт іншого запису або запис тіла на місці.

Два артефактні виходи одного Recipe мають однакову назву файлу

Блок artifacts: у Recipe називає один вихід на ключ, а bundle, імпортований за ключем, додає свої файли під ним. Два виходи з однією назвою файлу означали б, що один перезапише інший, тож збірка зупиняється, а не вибирає, який із них залишиться.

Це залишковий запобіжник, і сказати про це — частина того, чим він є. Вихід називається за ключем, під яким його записано, ключі мапи унікальні в межах одного документа, а поверхня написання обмежує ключ однією назвою файлу, — тож два записані елементи не можуть зіткнутися, і ключ так само не може збігтися з вкладеною назвою, яку створює bundle іншого ключа. Запобіжник іще охоплює вміст, що потрапив у проєкцію, оминувши власну відмову документа щодо дубльованих ключів: стан, зібраний під час роботи збірки, а не прочитаний із файлу. Тому зіткнення, про яке тут повідомлено, вказує на те, як було зібрано збірку, а не на рядок, який ви можете побачити.

Його виявляють для кожного Recipe окремо щодо власних виходів цього Recipe, і саме це відрізняє його від випадку, коли два різні учасники потрапляють на один шлях у збірці, — це «Two contributors write the same output path (Два учасники записують однаковий вихідний шлях)» вище, з іншим способом виправлення.

Повідомлення, що виводиться:

artifacts output filename collision: two artifact outputs carry the same filename (Recipe "<recipe>", artifact output "<filename>" emitted more than once) (зіткнення назв вихідних файлів artifacts: два артефактні виходи мають однакову назву файлу; Recipe, артефактний вихід виведено більше одного разу)

Як виправити: відкрийте Recipe, названий у повідомленні, і звірте його ключі artifacts: з файлами, які додає кожен імпортований ним bundle. Якщо ключі справді різні, а зіткнення залишається, документ ні до чого, і про повідомлення варто сказати тим, хто підтримує збірку.

Файл пакета ArtifactLibrary не називає власного файлу під ключем, за яким його імпортовано

Запис artifacts:, що імпортує пакет, розгортається в один вихід на кожен файл цього пакета, і кожен вкладено під ключ, за яким записано імпорт. Отже, ключ називає каталог, і кожен файл, який додає пакет, належить під ним, під власним іменем. Ім’я файлу, що виходить за межі цього каталогу, називає абсолютне розташування або не називає нічого, цій умові не відповідає, і збірка зупиняється, а не розміщує файл там, де споживацький Recipe ніколи цього не обирав.

«Не називає нічого» охоплює кожне ім’я, яке не є єдиним написанням одного файлу під ключем. . і ./, а також ім’я, що згортається назад до ключа, як-от x/.., називають сам ключ, тож файл було б записано там, де має бути каталог ключа. Ім’я з кінцевим чи подвоєним / або з частиною . чи .. — x/, a//b, ./a, a/./b, a/../b — є другим написанням файлу, яке може мати інше ім’я: a//b поряд із a/b — це два імені одного файлу, і один було б записано поверх іншого без повідомлення про колізію. Порожнє ім’я також відхиляється.

Ця перевірка запобігає не запису за межі вихідного каталогу, а непомітній зміні структури. Місце запису файлів перевіряється ще раз, тож ім’я, що виходить достатньо далеко, буде відхилено там у будь-якому разі. Через ту перевірку проходить ім’я, що піднімається рівно на один рівень: воно потрапляє назад у вихідний каталог, у позицію, якої ніхто не обирав. Це гірше за відхилений запис, бо кожна перевірка колізій на цьому шляху читає ім’я так, як його складено, а не так, як воно розв’язується, — тож два такі файли можуть потрапити в один вихід, і жодна перевірка не повідомить про колізію, а який із них залишиться, не визначає нічого, що хтось написав.

Вкладена структура, просто записана всередині ключа, не зачіпається. Пакет може мати власні підкаталоги, як-от rbac/role.yaml, і вкладення їх під ключ споживання — це саме те, для чого ключ існує. Ім’я, яке лише містить крапки всередині частини, як-от ..config чи role.v1.yaml, є звичайним ім’ям.

Споживацький Recipe і опублікований пакет зазвичай пишуть різні автори, тому повідомлення називає обидві половини разом зі способом виправлення.

Запис artifacts:, який пише власний Recipe компонента, визначається до будь-якого рендерингу, тому повідомлення прив’язано до блоку artifacts: у цьому Recipe, і воно називає спершу файл, потім бібліотеку, з якої він походить, і запис, у якому його споживають. Про кожен файл пакета з відхиленим іменем повідомляється за одну збірку; якщо їх кілька, результати групуються під 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 ”/” (ім’я файлу пакета artifact-library не називає власного файлу під ключем artifacts, під який вкладено його вихід. Перейменуйте файл у пакеті ArtifactLibrary на звичайне ім’я файлу під ключем artifacts, у якому його споживають, як-от «config.yaml» чи «rbac/role.yaml», — без частини «.» чи «..» і без початкового, кінцевого чи подвоєного «/»)

Запис artifacts:, який пише FeatureRecipe, повідомляє про ту саму умову під час розв’язання пакета, називаючи рецепт, у якому його записано, і перший такий файл:

artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under (Recipe "<recipe>", artifact "<key>", bundle file "<filename>"). rename the file inside the ArtifactLibrary bundle to an ordinary file name beneath the artifacts key it is consumed at, such as “config.yaml” or “rbac/role.yaml” — no ”.” or ”..” part, and no leading, trailing or doubled ”/” (ім’я файлу пакета artifact-library не називає власного файлу під ключем artifacts, під який вкладено його вихід. Перейменуйте файл у пакеті ArtifactLibrary на звичайне ім’я файлу під ключем artifacts, у якому його споживають, як-от «config.yaml» чи «rbac/role.yaml», — без частини «.» чи «..» і без початкового, кінцевого чи подвоєного «/»)

Як виправити: перейменуйте файл у ArtifactLibrary на звичайне ім’я файлу під ключем. Якщо бібліотека не ваша, імпорт іншого пакета або запис вмісту на місці дозволяє збірці пройти, доки виправлення вносять у першоджерело. Файл, який має потрапити зовсім в інше місце, — це другий запис artifacts: під ключем, до якого він належить, а не ім’я, що туди веде.

Імпортований артефакт більше не відповідає дайджесту, записаному поряд із його Recipe

Вміст запису artifacts:, що імпортує локальний файл, фіксується, коли фіксується Recipe, — командою aggrega pin або pull чи push, яким доручено виконати той самий крок: дайджест байтів файлу записується в entity.lock поряд із Recipe. Запис boundary.artifacts: у Recipe фіксується і порівнюється так само, під іменем boundary/<key>, яке йому дає повідомлення. Кожна збірка заново читає файл, знову обчислює дайджест і відхиляє розбіжність — тож файл, змінений після фіксації, ніколи не рендериться так, ніби його перевірено. aggrega pull --verify виконує те саме порівняння і повідомляє про розбіжність тим самим повідомленням.

Порівнюється вміст запису, а не результат його рендерингу. Тіло артефакту — це шаблон, і його обчислення підставляє значення, що різняться для кожного екземпляра компонента, тож дайджест виходу не збігався б для кожного екземпляра з іншими значеннями. Записаний вміст — той самий текст для кожного екземпляра, що прив’язує Recipe, і саме тому з одним записаним дайджестом і слід порівнювати.

Recipe, який ніхто не зафіксував, не має фіксації поряд, і збірка його не порівнює. Для збірки відсутність фіксації не є розбіжністю; це означає, що порівнювати нічого. Натомість pull для такого Recipe зупиняється, як описано в An entity reads an input the lock beside it records no pin for (Сутність читає вхідні дані, для яких lock поряд не записує фіксації). Lockfile, записаний до зміни файлу, повідомляє першим, бо рядок сутності охоплює й імпортований файл, як пояснено в A local source no longer matches the pins recorded beside its Recipe (Локальне джерело більше не відповідає фіксаціям, записаним поряд із його Recipe), де той самий розділ указує, коли збірка стикається саме з цим порівнянням.

Три поверхні виконують ту саму перевірку над різними документами — власним Recipe компонента, Feature, приєднаною до компонента, і Feature, приєднаною до межі, — тож вміст FeatureRecipe звіряється з дайджестом, записаним поряд із FeatureRecipe, а не поряд із Recipe компонента-хоста. На двох поверхнях приєднання повідомлення називає також приєднання, що й указує, який документ відкрити.

Повідомлення, що виводяться:

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 (вміст імпортованого артефакту не відповідає дайджесту, записаному для нього в entity.lock. Якщо файл змінено навмисно, виконайте aggrega pin для сутності, що його імпортує, щоб записати новий дайджест; інакше відновіть файл) 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 (вміст імпортованого артефакту не відповідає дайджесту, записаному для нього в entity.lock. Якщо файл змінено навмисно, виконайте aggrega pin для сутності, що його імпортує, щоб записати новий дайджест; інакше відновіть файл)

Як виправити: є дві відповіді, і правильна залежить від того, чи зміна була навмисною. Якщо так, виконайте aggrega pin для Recipe, щоб фіксацію було взято заново з поточних байтів файлу, і закомітьте entity.lock, який вона перезаписує. Якщо ні, відновіть файл — записаний дайджест є записом зафіксованих байтів, а збірка, що відрендерила б змінений файл, постачала б вміст, який ніщо не перевірило.

Локальне джерело більше не відповідає пінам, записаним поруч із його Recipe

Для Recipe або FeatureRecipe, чий source: називає каталог або файл поруч із ним, це джерело закріплюється, коли закріплюється сутність, — командою aggrega pin або командою pull чи push, якій доручено виконати той самий крок. Файл entity.lock поруч із сутністю записує по одному дайджесту на кожен файл, який джерело додає до вмісту публікації сутності, з ключем за шляхом файлу. Щойно lock-файл їх записав, кожна збірка порівнює джерело в його поточному стані з цими пінами, перш ніж provider його прочитає, і відхиляє розбіжність, — тож чарт або модуль, змінений після закріплення, ніколи не рендериться так, ніби його перевірено. aggrega pull --verify виконує те саме порівняння й повідомляє про розбіжність тим самим повідомленням. Збірка називає екземпляр компонента, джерело якого вона розв’язувала, і документ Recipe під ним.

Джерело порівнюється як один набір файлів. Файл, вміст якого змінився, файл, доданий до джерела, і файл, вилучений із нього, кожен змінюють те, з чого рендериться сутність, тому про кожен повідомляється з дайджестом, який файл має зараз, і дайджестом, записаним для нього. Файл поруч із сутністю, який джерело не додає, — примітка або README поряд із Recipe, — не порівнюється. Джерело, записане як шаблон, наприклад ./charts/{{ .values.flavour }}, додає кожен файл у каталозі сутності, оскільки який каталог воно називає, вирішує кожен Release; для такої форми повідомляється про зміну будь-якого файлу в каталозі.

Recipe, lock-файл якого не записує піна для його джерела, не має нічого для порівняння під час збірки. Збірка його не відхиляє; його відхиляє pull або push, що не закріплює, як описано в An entity reads an input the lock beside it records no pin for (Сутність читає вхідні дані, для яких lock-файл поруч із нею не записує піна). Піни, які lock-файл досі записує для локального джерела, якого Recipe більше не оголошує, не закріплюють нічого, що він читає, тож їх ні з чим не порівнюють. Recipe, який pull розв’язав із реєстру, натомість покривається дайджестом, який lockfile записує для вмісту його публікації.

Lockfile, записаний до зміни, повідомляє першим. Lockfile записує сутність за тим, що вона містить, і файли джерела є частиною цього, тож збірка або aggrega pull --verify, що має lockfile, записаний до зміни файлу, зупиняється до запуску цього порівняння з помилкою The lockfile no longer matches what the release resolves to (Lockfile більше не відповідає тому, у що розв’язується реліз), яка називає сутність і обидва дайджести. Звичайний aggrega pull називає змінений файл помилкою An entity reads an input the lock beside it records no pin for (Сутність читає вхідні дані, для яких lock-файл поруч із нею не записує піна). Те саме стосується імпортованого файлу. Якщо lockfile не має власного запису сутності, саме з цим порівнянням стикаються збірка і pull з перевіркою: Recipe або FeatureRecipe, який Manifest називає посиланням, що є також ім’ям Component або Feature, до якого доходить Release, записується під цим посиланням як Component або Feature, тож у lockfile нічого не змінюється, коли змінюються файли Recipe.

Повідомлення, що виводяться:

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 (файли локального джерела сутності не відповідають пінам, записаним для них в entity.lock (дайджест файлу відрізняється від записаного піна). Якщо джерело змінено навмисно, виконайте закріплення сутності, щоб записати її файли знову; інакше відновіть файли) 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 (файли локального джерела сутності не відповідають пінам, записаним для них в entity.lock (для файлу не записано піна). Якщо джерело змінено навмисно, виконайте закріплення сутності, щоб записати її файли знову; інакше відновіть файли) 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 (файли локального джерела сутності не відповідають пінам, записаним для них в entity.lock (файлу більше немає в джерелі, а його пін записано). Якщо джерело змінено навмисно, виконайте закріплення сутності, щоб записати її файли знову; інакше відновіть файли)

Як виправити: як і для імпортованого файлу, є дві відповіді, і правильна залежить від того, чи зміна була навмисною. Якщо так, виконайте aggrega pin для Recipe, щоб файли його джерела закріпилися знову, і закомітьте entity.lock, який команда перезаписує. Якщо ні, відновіть файли, названі в повідомленні.

Кожен файл, який містить публікація сутності, читається з власного каталогу сутності, і символьне посилання в ньому відхиляється, а не розіменовується. Розіменування опублікувало б байти, на які воно вказує, під власним ім’ям посилання — звідки б воно не вказувало, зокрема й поза каталогом сутності, — в артефакт, для якого потім обчислюється дайджест і який, де застосовується підписування, підписується. Пропуск же опублікував би артефакт, вміст якого непомітно відрізняється від вашого каталогу. Тому будь-яка форма посилання відхиляється однаково: посилання на файл, посилання на каталог, посилання в нікуди, посилання на самого себе і два посилання одне на одне.

Відмова відбувається всюди, де читаються файли сутності: командою aggrega pin, публікацією до того, як вона щось пакує (зокрема пробним запуском), командою pull і pull з перевіркою, що звіряють entity.lock із файлами сутності, збіркою, що порівнює локальне джерело з його пінами, і рендерингом, що читає каталог локального джерела до передачі будь-чого з нього provider. Повідомлення називає посилання за його шляхом поруч із документом сутності, а діагностика позиціонується на самому посиланні.

Посилання, яке виключають ваші правила ігнорування, не є файлом, що його містить сутність, тому його пропускають, як і будь-який інший файл, виключений цими правилами, і ніколи не розіменовують. Ці правила — ті, що записані в entity.lock під час закріплення сутності, тож рядок, доданий до .aggregaignore, набуває чинності, коли ви знову закріплюєте сутність.

Повідомлення, що виводиться:

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 (серед файлів, які містить сутність, є символьне посилання. Виправлення: замініть посилання копією того, на що воно вказує, розміщеною у власному каталозі сутності. Посилання в каталозі джерела можна натомість виключити рядком у .aggregaignore поруч із сутністю, що набуває чинності після повторного закріплення сутності. Посилання відхиляється, а не розіменовується, бо байти, на які воно вказує, потрапили б під ім’я посилання, звідки б воно не вказувало)

Як виправити: якщо сутності потрібне те, на що вказує посилання, замініть посилання його копією в каталозі сутності й закріпіть сутність знову. Якщо посилання існує для вашої зручності і сутність його не читає, додайте його шлях до .aggregaignore поруч із документом сутності й закріпіть знову. У розділі Які файли постачаються із сутністю описано правила, що визначають, що містить сутність.

An entity reads an input the lock beside it records no pin for (Сутність читає вхідні дані, для яких lock-файл поруч із нею не записує жодного піна)

Сутність Recipe або FeatureRecipe може залежати від байтів поза власним документом: віддаленого source:, координати якого записано повністю, файлу, який запис artifacts імпортує через $import, і файлів source:, що називає каталог або файл поруч із нею. Пін для кожного з них записується в entity.lock поруч із сутністю, і записати його — крок автора сутності, aggrega pin. Тому pull не записує ці піни самостійно: для сутності в одному з ваших каталогів каталогу, яку збирає Release, він порівнює те, що записав би цей крок, із тим, що містить lock, і зупиняється, коли в lock бракує піна — або є пін, якому вхідні дані більше не відповідають, — замість того щоб без запиту писати в каталог автора. Збірка, що сама заповнює свій lockfile, є pull і зупиняється так само.

Push зупиняється на тому самому порівнянні — для однієї сутності, яку він збирається опублікувати. До того як буде зібрано пакет і до звернення до будь-якого реєстру, він порівнює те, що записав би крок для сутності, з lock поруч із нею, і відмовляє так само — зокрема й під час пробного запуску, — якщо push не попросили виконати цей крок самостійно. Те, що повідомлення пропонує наприкінці, у цих двох випадках різниться, бо кожна команда має власні способи записати піни; те, про що воно повідомляє, — ні.

Локальне джерело звіряється зі своїми пінами як один набір файлів. Якщо lock не записує жодного з них, кожен файл, який додає джерело, тут повідомляється як відсутній. Якщо записує, файл, доданий після піна, повідомляється як відсутній, а змінений або видалений файл — як пін, якому вхідні дані більше не відповідають; збірка повідомляє про ту саму зміну як A local source no longer matches the pins recorded beside its Recipe (Локальне джерело більше не відповідає пінам, записаним поруч із його Recipe). Піни, які lock досі записує для локального джерела, якого Recipe більше не оголошує — його source: видалено або тепер він називає віддалений артефакт, — не закріплюють нічого, що читає Recipe, тож не зупиняють ні pull, ні push, ні pull з перевіркою, ні збірку; наступний aggrega pin їх відкидає.

Повідомлення називає кожні відсутні вхідні дані за класом. Кожне з них — це remote source, назване своєю url-адресою та версією, до якої воно розв’язалося, imported file, названий ключем artifacts, що його споживає, або local source file, названий своїм шляхом поруч із сутністю, — тож ви знаєте, чи пін потрібен джерелу, чи файлу. Про кожну таку сутність у Release повідомляється за один запуск.

Сутність, розв’язана з реєстру, ніколи не звіряється з цим під час pull, бо її публікація вже звірялася. Вона зберігається в кеші вмісту, а не в каталозі, який ви створюєте, тож pull не читає й не пише lock поруч із нею, а її джерела звіряються з lockfile сутності Release. Сутність, опубліковану через aggrega push, було відхилено під час публікації, якщо її lock не записував кожного піна, який тоді записав би для неї крок, і цей lock передається всередині опублікованого пакета.

Повідомлення, що виводяться, від pull і від 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 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

Середня частина повідомлення про публікацію називає те, що приймає інтерфейс, з якого ви публікували: --pin-sources у терміналі, поле pinSources у демоні та аргумент pin_sources інструмента асистента.

Як виправити: якщо сутність ваша, виконайте для неї aggrega pin і закомітьте entity.lock, який він записує, а потім знову виконайте pull або push — або виконайте push з --pin-sources, що запускає цей крок до збирання пакета. Якщо вона чужа — каталог, який ви споживаєте з окремого каталогу, — її видавець ще не закріпив її; встановіть pin_sources_at_pull: true у конфігурації робочого простору, щоб кожен pull сам записував піни, або передайте --pin-sources одному pull. aggrega pin повністю описує цей крок.

A provides: template could not be evaluated (Не вдалося обчислити шаблон provides)

Запис provides: — це шаблон, що створює значення, яке інший компонент читає через з’єднання залежності. Цей стан повідомляє запис, який не вдалося обчислити: шаблон, що не розбирається, функція, яку він викликає і яку цей інтерфейс не реєструє, посилання, що спускається через щось, чого контекст рендерингу не надав, або читання index ключа, якого немає в мапі.

Він відрізняється від двох відмов, що виконуються до обчислення в тому самому блоці, — посилання на корінь поза самодостатнім набором і посилання, яке відхиляє порядок, заданий автором блоку, — обидві задокументовано вище. Вони називають вираз, який слід змінити; цей стан несе те, що повідомило саме обчислення, тому поруч із ним названо запис.

Повідомлення, що виводиться, із назвою екземпляра компонента, запису всередині блоку та того, що повідомило обчислення:

provides template evaluation failed (node "<instance>", provides["<key>"], <what the evaluation reported>) (не вдалося обчислити шаблон provides (вузол, provides[], що повідомило обчислення))

Заголовок містить код цієї умови, E0056, хоч би що повідомило обчислення. Якщо обчислення зупинилося на власній умові зупинки — зазвичай це читання через index ключа, якого мапа не містить, — цю умову повідомляють під цією, а не замість неї: під caused by (2): спершу йде речення цієї умови, а потім власний звіт обчислення разом із його реченням. Тож читач, який зіставляє коди, пов’язує кожен невдалий запис provides: з E0056, а причину невдачі обчислення читає з умови під нею, речення якої відповідає її власному коду в таблиці всіх умов — E0327 для відсутнього ключа.

Як виправити: відкрийте блок provides: у Recipe за ключем, який називає повідомлення, і прочитайте вказану причину — зазвичай вона називає позицію розбору або функцію. Обробка відсутніх ключів на цьому інтерфейсі рендерить відсутній кінцевий ключ як порожнє значення, а не як помилку, тож збій тут — структурна вада: шаблон, що не розбирається, посилання, що спускається через контейнер, якого так і не надали, або читання index ключа, якого немає в мапі, — це називає вказана причина. Якщо значення справді необов’язкове, читайте його через допоміжну функцію optional, а не спускайтеся в те, чого може не бути.

A Recipe or FeatureRecipe does not publish a provides key its contract declares (Сутність Recipe або FeatureRecipe не публікує ключ, який оголошує її контракт)

Component і Feature кожна оголошують у schema.provides ключі, які публікуватиме будь-що, що їх зв’язує, — вихідний контракт, відповідно до якого споживач записує свої з’єднання. Recipe, прив’язаний до Component, і FeatureRecipe, прив’язаний до Feature, мають створити кожен ключ, названий у цьому контракті. Той, що цього не робить, відхиляється, бо інакше відсутній ключ не доставив би взагалі нічого: посилання споживача надійшло б як невстановлена змінна, порожній аргумент або файл, якого немає, і ніхто б не пояснив чому.

Контракт — це наявність ключів, і нічого більше. Кожен оголошений ключ має бути присутнім; додаткові ключі дозволені. Самі значення ніколи не перевіряються — це непрозорі вказівники, що передаються як рядки, тож типи, які оголошує контракт, лишаються твердженням для споживача, а не перевіркою, яку виконує збирання.

Повідомляється про кожну нестачу. Recipe, якому бракує трьох ключів, породжує три знахідки, кожна з яких розміщена біля власного запису в блоці provides: цього Recipe, тож усі три виправляються за одне збирання. Повідомлення називає відсутній ключ, тип, чий контракт його оголошує, і екземпляр, до якого був прив’язаний Recipe, — саме останнє розрізняє дві знахідки, коли один Recipe обслуговує кілька екземплярів одного типу.

Повідомлення, що виводиться:

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 або FeatureRecipe не публікує ключ provides, який оголошує контракт schema.provides її абстрактної сутності; оголошений типом компонента, прив’язаний до екземпляра компонента)

Пара Feature і FeatureRecipe повідомляє про ту саму умову через власне розв’язання приєднання, називаючи пару та ключ:

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 або FeatureRecipe не публікує ключ provides, який оголошує контракт schema.provides її абстрактної сутності; FeatureRecipe не публікує ключ provides, оголошений контрактом schema.provides сутності Feature)

Там вона повідомляє про перший відсутній ключ у відсортованому порядку і зупиняється, тож ця пара називає один ключ за збирання, тоді як пара Component називає їх усі. Ключі в будь-якому разі обходяться у відсортованому порядку, і саме це робить обидва варіанти однаковими між запусками.

Як виправити: додайте відсутній ключ до блоку provides: сутності Recipe або FeatureRecipe або вилучіть його з schema.provides сутності Component або Feature, якщо ніщо не має його публікувати. Ключ, шаблон якого відтворюється в ніщо, все одно публікується з порожнім рядком як значенням, тож запис, що присутній і порожній, виконує контракт і тут не повідомляється. Якщо порожнє значення має зупинити збирання, відхиліть його в твердженні: твердження Recipe читають його розв’язані значення provides:.

An assertion stopped the build (Твердження зупинило збирання)

Component, Feature, Recipe або FeatureRecipe може містити assertions: — іменовані шаблони, призначення яких — відхилити вхідні дані, а не створити текст. Твердження викликає fail, і саме цей виклик зупиняє збирання; аргументом є повідомлення, яке автор написав для того, хто на нього натрапить.

Твердження обчислюються у двох точках, щоб правило читало той стан, якого воно стосується: твердження в Component або Feature виконуються, щойно каталог розв’язано, і до будь-якого відтворення, а твердження в Recipe або FeatureRecipe — щойно прив’язку встановлено, і до відтворення цієї прив’язки.

Посилання на ключ, який ніщо не надає, теж повідомляється тут. Поверхня обчислює зі строгою обробкою відсутніх ключів саме для того, щоб предикат, посилання якого відтворилося як порожнє, не міг порівняти з нічим і непомітно пройти, — інакше одна друкарська помилка скасувала б правило, для забезпечення якого написано твердження. Саме тому звичайний default не надає запасного значення на цій поверхні: голе посилання зупиняє обчислення раніше, ніж запасне значення встигне спрацювати. Захистіть посилання за допомогою hasKey або використайте допоміжну функцію optional; читання через index теж зупиняє збирання, називаючи ключ, як описано в «A template indexes a map with a key the map does not hold (Шаблон індексує мапу ключем, якого мапа не містить)».

Повідомлення, що виводиться, називає вид і тип сутності, екземпляр і твердження, а потім містить повідомлення, написане самим твердженням:

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>": template: <kind>/<type>/<instance>/<name>:<line>:<column>: executing "<kind>/<type>/<instance>/<name>" at <fail …>: error calling fail: assertion failed: <the message the assertion wrote> (помилка під час виклику fail: твердження не виконано)

а для ключа, якого ніщо не надає, — речення шаблонізатора після власного речення умови:

<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>" (твердження не виконано: під час виконання шаблону мапа не має запису для ключа)

а коли не вдалося саме обчислення, а не предикат:

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>" parse: <what the parse reported> (екземпляр, твердження: твердження, розбір)

Значення, оголошене чутливим, не з’являється в повідомленні. Якщо твердження читає таке значення і викликає fail зі своїм реченням, повністю записаним як один рядок у лапках, — fail "…", без нічого переданого в нього конвеєром і без нічого складеного, — повідомлення містить це речення так, як його записано, хоч би що містило значення, бо речення не цитує нічого з того, що прочитало твердження. Якщо його повідомлення цитує значення, на місці значення в повідомленні стоїть <redacted>. Якщо повідомлення складене будь-яким іншим способом і те, що зробило твердження, залежало від вмісту значення, повідомлення після хибного виразу замінюється на failure text withheld: this template reads a value declared sensitive, and the failure depends on what that value holds; зупинка та її код не змінюються. Що вважається оголошеним і які відмови лежать поза цим, описано в vocabulary/compact-form-authoring.md «Що відмова каже про оголошене значення».

Під час окремої перевірки сутність повідомляє про невиконане твердження як про попередження. aggrega validate з файлом Recipe, перевірка цього файлу редактором через aggrega serve та інструмент validate у aggrega mcp з entity будують Recipe довкола заповнювачів і типових значень схеми, а не значень, які встановлює Release, тож вони не можуть відрізнити твердження, що чекає на Release, від зламаного. Там твердження, яке викликає fail, — власне твердження Recipe або оголошене сутністю Component, яку він реалізує, — повідомляється як попередження з наведеним вище повідомленням, завершеним реченням A Release must satisfy this assertion before a build of it can pass., і перевірка проходить. Посилання на ключ, який ніщо не надає, і твердження, що не розбирається, не є невиконаними твердженнями: кожне з них — помилка в самому тексті твердження, і перевірка оцінює її так само, як будь-яку іншу помилку. Збирання завжди має Release і зупиняється на твердженні, як описано тут; див. невиконане твердження — це попередження.

Як виправити: повідомлення після останньої двокрапки належить авторові твердження, і саме воно каже, що змінити, — твердження пишуть так, щоб натрапивши на нього, ви дізналися відповідь. Якщо повідомляється про відсутній ключ, а не речення автора, помилка в самому твердженні: виправте посилання або захистіть його, як описано вище. Якщо правило не повинно застосовуватися до цієї сутності Release, це питання до сутності, що містить твердження, а не до вашого власного файлу.

A pipeline step addresses documents the node does not have (Крок конвеєра адресує документи, яких вузол не має)

Крок конвеєра адресує документ за областю та ключем. Три умови охоплюють випадки, коли адреса ні на що не вказує, і кожна зупиняє збірку, щоб крок не повідомив про успіх редагування, якого ніколи не було.

Вузол його не виводив. Патч називає пару «область і ключ», якої немає серед документів, створених цим вузлом:

node "<instance>": pipeline PATCH targets a document the node did not emit (вузол: PATCH конвеєра спрямований на документ, який вузол не виводив)

Немає хоста, який можна адресувати. Крок звернувся до документів хост-компонента в місці, яке не стоїть проти жодного, — у власному конвеєрі компонента, єдина область якого — його власний вивід, або у сутності Feature, приєднаній до межі, а не до одного компонента. Область хоста порожня всюди, де виконується такий конвеєр, тож адреса в ній ні на що не вказує:

node "<instance>": pipeline /host operation from a step with no host component (вузол: операція /host конвеєра з кроку без хост-компонента)

Документ не має дерева, яке можна адресувати. Деякі одиниці не мають структури, у яку може вказувати шлях, — бінарне тіло, довільний текст, ділянка, яку ціль не може безпечно обійти. Така одиниця все одно передається крокові, щоб її можна було вибрати й вивести цілою; але патчити її не можна:

node "<instance>": pipeline PATCH target is not parseable structured YAML/JSON (вузол: ціль PATCH конвеєра не є структурованим YAML/JSON, який можна розібрати) pipeline PATCH target is not parseable structured YAML/JSON (node "<instance>", document "<key>") (ціль PATCH конвеєра не є структурованим YAML/JSON, який можна розібрати (вузол, документ))

Кожна надходить разом із власним поясненням обходу щодо адреси під нею, і кожна позиціонується на екземплярі компонента, конвеєр якого її створив.

Про дві з трьох також повідомляється ще до будь-якого обходу. Чи має місце документи хоста взагалі, випливає з того, де написано конвеєр, тож крок, який оголошує, що працює з документами хоста, у місці, де їх немає, називається, щойно збірка знає, що оголошує кожен плагін, не чекаючи рендерингу вузла, — а сутність Feature, приєднана до межі, називається разом із кроком:

pipeline /host operation from a step with no host component (операція /host конвеєра з кроку без хост-компонента) pipeline /host operation from a step with no host component ("<attachment>") (операція /host конвеєра з кроку без хост-компонента (приєднання))

Ці два прочитання — поділ однієї умови, а не та сама знахідка двічі: те, що може вирішити оголошення, вирішується з оголошення, а те, що бачить лише виконання, лишається за виконанням, — крок, що оголошує власну область, усе ще може повернути операцію щодо іншої.

Ці три — форма, що зупиняє збірку, тих відмов в адресації, про які повідомляє сам обхід конвеєра і які задокументовано вище в розділі «A pipeline patch addresses a document the set does not hold, or one with no tree to address (Патч конвеєра адресує документ, якого немає в наборі, або документ без дерева для адресації)».

Як виправити: усі три стосуються автора кроку, а не вас. Для відсутньої цілі патчте документ, який вузол справді виводить, або виведіть потрібний у попередньому кроці й патчте його в пізнішому — крок може прочитати, які ключі йому передано. Для відсутнього хоста перенесіть крок у місце, що стоїть проти хост-компонента, адресуйте натомість власні документи місця або приберіть крок. Для одиниці без дерева замініть патч виведенням цілої одиниці: непрозоре тіло замінюють, а не редагують.

A pipeline patch addresses output that has not been assembled yet (Патч конвеєра адресує вивід, який ще не зібрано)

Деякі провайдери згортають вивід групи диспетчеризації для кожного вузла в один документ — об’єднаний файл compose, парасольковий чарт. Доки це об’єднання не відбулося, окремих документів немає, лише фрагменти, тож патчу, що адресує один із них, нема куди вказувати. Тому конвеєр щодо такого компонента відкладається цілком і повторюється, щойно об’єднання створить документи; це звичайний шлях, і від автора він нічого не вимагає.

Ця умова доходить до збірки, коли патч усе ж потрапляє на фрагмент. Випадок, який вона називає, — власний вивід приєднаної сутності Feature. Коли провайдер компонента згортає свою групу, увесь конвеєр приєднання затримується, доки об’єднання не створить документи, — і повторному виконанню передаються лише документи компонента. Крок щодо власного виводу сутності Feature пропонується лише під час рендерингу компонента, тобто до будь-якого об’єднання, тож йому нема чого адресувати. Це так незалежно від того, як рухається власний вивід сутності Feature: чи приєднується він до об’єднання, чи записується як окремі документи, його власна область ніколи не є областю, яку несе повторне виконання.

Виведення це ніколи не зачіпає. Виведення додає документ, а не редагує його, і виконується для кожного вузла для будь-якого провайдера, тож воно цілком поза цим.

Про умову повідомляється до будь-якого обходу, на основі того, що оголошують плагіни й провайдери, і ще раз як нижня межа під час рендерингу вузла. Повідомлення, що виводяться:

pipeline PATCH targets an assembler provider’s pre-assembly fragments ("<attachment>") (PATCH конвеєра спрямований на фрагменти провайдера-складальника до складання (приєднання)) 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 конвеєра спрямований на фрагменти провайдера-складальника до складання (вузол, документ області рендериться провайдером-складальником). фаза після складання повторно виконує цей PATCH, щойно документи стануть окремими)

Як виправити: адресуйте документи компонента замість власних документів сутності Feature — саме ця форма повторюється після об’єднання; або переведіть компонент на провайдер, який не згортає свою групу диспетчеризації; або приберіть крок. Який із трьох варіантів правильний, залежить від того, що крок мав змінити, і повідомлення називає адресовану область, щоб ви могли це визначити. Зміна власного capability: сутності FeatureRecipe до них не належить: вона не змінює, яку область отримує повторне виконання після об’єднання, а саме про це ця умова.

A pipeline step’s plugin does not claim the provider rendering what it addresses (Плагін кроку конвеєра не заявляє провайдер, що рендерить адресоване)

Плагін, який використовує крок конвеєра, може оголосити провайдери, з якими його протестовано. Цей список — явна заява, а не неявне «будь-що схоже»: запуск плагіна з провайдером, якого він не називає, ризикує застосувати патч, написаний для іншої форми виводу, тож збірка зупиняється замість спроби.

Крок зіставляється з тим провайдером, який рендерить документи, що їх цей крок адресує, — власним провайдером компонента для кроку щодо документів компонента і власним провайдером сутності Feature для кроку щодо її документів. У сутності Feature, приєднаній до компонента, виникають обидва, і це два різні значення з двох різних документів.

Порожній або відсутній список заяв не відповідає нічому, тож кожен крок, що використовує такий плагін, повідомляє тут. Плагін, якого збірка не змогла запитати, — інший випадок, і тут він не повідомляє: неотриманий самозвіт — це відсутність заяви, а не порожня заява, і такий крок зупиняється з самою помилкою розв’язання, завантаження чи самозвіту, яку й слід виправити.

Про це повідомляється, щойно збірка знає, що кожен плагін декларує про себе, ще до запуску, який викликав би крок, і один раз на кожен написаний крок, а не один раз на збірку, — тож автор бачить усі проблемні кроки конвеєра з однієї збірки. Імена Provider зіставляються точно.

Повідомлення, що виводяться: перше — з власного конвеєра компонента, друге — з конвеєра сутності Feature, яке також називає приєднання:

pipeline plugin is not compatible with the rendering provider ("<provider>") (плагін конвеєра несумісний із провайдером рендерингу (провайдер)) pipeline plugin is not compatible with the rendering provider ("<attachment>", "<provider>") (плагін конвеєра несумісний із провайдером рендерингу (приєднання, провайдер))

Як виправити: знахідка позиціонується на написаному кроці, і названий у ній провайдер — те, з чим слід узгодити оголошення. Якщо плагін ваш, додайте провайдер до оголошеної сумісності, щойно протестуєте з ним. Якщо ні, виберіть версію плагіна, що заявляє цей провайдер, рендерте цю область через провайдер, який плагін заявляє, або приберіть крок.

A provider refused a node’s input (Провайдер відхилив вхідні дані вузла)

Провайдер може перевірити вхідні дані, які він отримує для компонента, перед їх рендерингом і повідомити про знайдене. Результати рівня halt зупиняють збірку; результати рівнів warning та information виводяться разом із результатом збірки й ніяк не змінюють згенеровані байти.

Це власне прочитання ваших вхідних даних провайдером, а не компілятором, тож те, проти чого він заперечує і наскільки конкретно про це повідомляє, вирішує провайдер. Компілятор називає компонент і провайдер і передає повідомлення провайдера в тому вигляді, у якому їх було повернуто; якщо провайдер повідомив про кілька проблем, вони надходять разом, розділені крапкою з комою, тож одна збірка повідомляє вам про всі.

Та сама маршрутизація використовується незалежно від того, чи належать вхідні дані до власного Recipe компонента, чи до приєднаного Feature, тож перевірка провайдера читається однаково в обох випадках.

Повідомлення, що виводиться:

provider rejected node input: node "<instance>", provider "<provider>": <the provider's messages> (провайдер відхилив вхідні дані вузла: вузол, провайдер: повідомлення провайдера)

Як виправити: прочитайте повідомлення провайдера — вони називають, що саме в розв’язаних вхідних даних він не зміг прийняти. Вхідні дані збираються зі значень Recipe і власної конфігурації компонента, тож виправлення зазвичай потрібне в одному з них; що саме вимагає провайдер, описано на його довідковій сторінці. Якщо провайдер заперечує проти того, що ви не можете змінити з документа, це питання до автора Recipe або плагіна.

A provider rendered the same input twice and produced different output (Провайдер двічі відрендерив ті самі вхідні дані й отримав різний результат)

За ідентичних вхідних даних збірка дає ідентичний результат — саме з цим контрактом інструменти рев’ю та розгортання звіряють результат збірки. Режим збірки, що вмикається за бажанням, перевіряє це безпосередньо: кожен компонент рендериться двічі з тих самих вхідних даних, і згенеровані байти порівнюються. Провайдер, два рендери якого не збігаються, переносить стан між ними або іншим чином не є функцією своїх вхідних даних, і збірка зупиняється.

Звичайна збірка рендерить кожен компонент один раз, тож ця умова трапляється лише в режимі перевірки. Наявність цього режиму нічого не змінює у звичайній збірці.

Порівнюється сирий згенерований результат провайдера — ті самі байти, з яких вирізаються відрендерені артефакти, — тож виявляється відмінність будь-де в тому, що він створив, а не лише та, що доходить до фінального файлу.

Повідомлення, що виводиться:

rendering node "<instance>": node "<instance>" (provider "<provider>"): two renders of identical input produced different output: provider render is not deterministic (рендеринг вузла: вузол (провайдер): два рендери ідентичних вхідних даних дали різний результат: рендер провайдера не детермінований)

Як виправити: спершу знайдіть, чим відрізняються дві збірки компонента, названого в повідомленні, — зберіть його двічі й порівняйте результати. Якщо відмінність — це значення, яке підключений вами чарт генерує заново під час кожного рендеру, — випадковий пароль, згенерований ключ, позначка часу в Secret чи ConfigMap, — то вада в результаті цього чарту, а не в провайдері, і ви можете усунути її самі одним із двох способів. Задайте значення через параметр, який чарт для нього пропонує, з valuesMapping: у Recipe, щоб чарт перестав його генерувати. Або, якщо згенерований документ не повинен потрапляти в Release — наприклад, Secret, який оператор надає окремо, — виключіть його зі збірки записом omits: у Recipe; див. Recipe → Поле omits:. Інакше вада на боці провайдера, а не ваших документів, і нічого, що ви можете написати, її не усуне. Повідомте про неї тому, хто публікує плагін, що обслуговує цей провайдер, назвавши компонент, указаний у повідомленні, — типові причини: позначка часу, випадкове значення або порядок, що відповідає ітерації по мапі, а не порядку, у якому писав автор. Доки ваду не виправлено, звичайний режим збірки не зачеплено, а практичне рішення — закріпити плагін на версії, яка пройшла перевірку.

An omits entry left out nothing the source rendered (Запис omits не виключив нічого з того, що відрендерило джерело)

Кожен запис списку omits: у Recipe чи FeatureRecipe, що застосовується до збірки — його when: відсутнє, порожнє або істинне, — має виключити з результату принаймні щось із того, що відрендерило джерело: документ, який рендерить чарт, сервіс, том або конфігурацію, оголошені у файлі compose, або ресурс, оголошений у шаблоні CloudFormation. Провайдер, що рендерить джерело, зіставляє кожен запис із відрендереним і повідомляє, скільки одиниць виключив кожен запис; запис, що не виключив жодної, зупиняє збірку.

Запис, що нічому не відповідає, — це твердження про джерело, яке більше не є правдивим. Типова причина — оновлення джерела, яке перейменувало або вилучило те, що називає запис, — і тоді перейменований документ чи сервіс потрапляє в результат під новою назвою, а саме від цього запис і мав захистити, — інша причина — помилка в самому записі. Якщо пропустити це, буде відвантажено те, що запис мав виключити, тож збірка зупиняється й називає запис.

Повідомлення називає вузол, провайдер, документ, що оголошує запис, і позицію запису в списку omits: цього документа з відліком від 0, а також kind, name і namespace, у які розв’язався запис, причому namespace — лише якщо запис його називає. Для FeatureRecipe, приєднаного до компонента, вузлом є цей компонент; для приєднаного до межі рядок над повідомленням називає приєднання та його межу. Якщо кілька записів нічому не відповіли, називається перший у порядку, у якому ви їх написали, тож при кожному запуску називається той самий запис. Поле, шаблон якого прочитав значення, оголошене чутливим, показується як <redacted>, а не як розв’язане значення. Запис, який відкинула його умова when:, ніколи не передається провайдеру й не перевіряється.

Повідомлення, що виводиться. Категорія доходить до вас у заголовку у квадратних дужках:

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 (запис omits не виключив нічого з того, що відрендерило джерело (вузол, провайдер, документ, позиція, kind, name, namespace). виправте запис, щоб він називав те, що рендерить джерело, або вилучіть його; типова причина — оновлення джерела, яке його перейменувало або вилучило)

Заголовок містить короткий код цієї умови, E0334.

Як виправити: порівняйте запис із тим, що джерело рендерить зараз, — зберіть без цього запису й подивіться, що рендерить компонент, — потім виправте kind, name або namespace запису чи вилучіть запис, якщо того, що він називав, більше немає. Для чарту запис називає документ за його власними kind, metadata.name і, якщо запис називає namespace, простором імен, у якому перебуває документ; для файлу compose — service, volume або config за ключем; для шаблону CloudFormation — ресурс за його Type і логічним ID у будь-якому із шаблонів джерела. Див. Recipe → Поле omits:.

A provider’s omitted counts do not match the omits entries it was handed (Кількості пропущеного від провайдера не відповідають переданим йому записам omits)

Провайдер, який оголошує, що пропускає відрендерені одиниці, повідомляє для кожного переданого йому запису omits:, скільки одиниць збіглося з цим записом, — одна кількість на запис, у порядку, в якому записи було передано. Звіт, якого немає, який містить замало чи забагато кількостей або містить кількість, меншу за нуль, не дає змоги визначити, чи запис узагалі щось пропустив, тому збірка зупиняється. Нічого з написаного вами цього не спричиняє: так повідомляється про провайдера, чий повернений результат не дотримується оголошеного ним контракту.

Повідомлення, що виводиться. Воно називає вузол і провайдера, потім скільки записів було передано і що повернулося — або скільки кількостей, або кількість, меншу за нуль, і запис, для якого її подано:

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) (кількості пропущеного від провайдера не відповідають переданим йому записам omits: вузол, провайдер, передано записів omits, повернуто кількостей пропущеного)

Заголовок містить короткий код цієї умови, E0336.

Як виправити: повідомте про це того, хто публікує плагін, що обслуговує цього провайдера, назвавши компонент, указаний у повідомленні. Що повинен робити провайдер, викладено в контракті плагінів у розділі Пропуск відрендерених одиниць.

Assembled output still carries a cross-boundary placeholder (Зібраний результат досі містить заповнювач для зв’язку між межами)

Коли залежність перетинає межу між двома зібраними результатами, значення, яке вона передає, неможливо знати під час рендерингу споживчої сторони — його публікує інша сторона, і воно розв’язується, коли обидві вже зібрано. Тому збірка записує заповнювач у вхідні дані споживчого компонента, а провайдер замінює його власною формою перехресного посилання, щойно збірка існує.

Ця умова повідомляє про заповнювач, який пережив цю заміну. Пережив — означає, що розв’язання до нього не дійшло: значення потрапило туди, куди провайдер не міг звернутися, — найчастіше вклеєне в довший рядок замість того, щоб стояти як ціле значення, — або перетин було позначено, а на іншому боці не було нічого, що його розв’язало б. Заповнювач ніколи не є допустимим результатом, тож збірка зупиняється, а не постачає файл, що його містить.

Повідомлення називає провайдера, який записав файл, і шлях, за яким файл розташований: шлях унікальний лише в межах однієї збірки, тому саме ці два значення разом ідентифікують один файл. Повідомляється про кожен проблемний файл, а не лише про перший, і про кожен — один раз, скільки б меж не наповнювали збірку, в якій він розташований. Про нього повідомляється щодо документа Release в цілому, а не щодо межі в ньому, — помилка в тому, як значення потрапило до файлу, а не в оголошенні межі, тож жодне оголошення межі змінювати не потрібно.

Повідомлення, що виводиться:

assembled output retains an unresolved cross-boundary link placeholder ("<provider>", "<output-path>") (зібраний результат зберігає нерозв’язаний заповнювач зв’язку між межами)

Як виправити: найпоширеніша причина — значення, яке споживча сторона вставила в довший рядок. Перехресне посилання має становити все значення, як яке його впроваджено, тож змініть зіставлення в Recipe так, щоб воно передавало його цілим, а натомість компонуйте навколо нього у власному словнику цілі. Якщо значення стоїть цілим, а заповнювач усе одно зберігається, помилка на боці розв’язання провайдера, і з нею слід звертатися до того, хто публікує цей плагін.

Шаблон може читати значення виробника безпосередньо зі з’єднання, за шляхом .context.uses.<alias>.provides, а у FeatureRecipe з областю межі — зі з’єднань межі в .boundary. Якщо з’єднання поєднує два компоненти, що рендеряться в різні виходи, а провайдер пов’язує його власним посиланням, кожне з цих значень потрапляє до шаблону як заповнювач, який провайдер замінює, щойно обидва виходи зібрано: посиланням між стеками або самим значенням. Тому шаблон може лише копіювати таке значення — записувати його цілим, усередині довшого рядка або через функцію, що залишає його без змін, як-от quote.

Порівняння, розгалуження, довжина чи функція, що змінює значення, — eq, if, len, upper, trimPrefix — були б обчислені за заповнювачем, а не за значенням, і непомітно. Збірка перевіряє це, обчислюючи шаблон двічі — один раз за заповнювачами й один раз за справжніми значеннями — і зупиняється, якщо після зворотної підстановки кожного заповнювача результати розходяться. Це стосується кожного шаблону, що читає таке з’єднання: власних шаблонів Recipe, injectMapping: прикріпленого FeatureRecipe та шаблонів FeatureRecipe з областю межі.

Повідомлення називає шаблон — поле й Recipe, до якого воно належить, — а для кожного значення provides, від якого залежить розбіжність, — компонент-споживач, псевдонім і сокет з’єднання та компонент-виробник. Значення, яке шаблон лише скопіював, не називається.

Повідомлення, що виводиться:

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 (шаблон робить більше, ніж копіює значення, прочитане з міжмежового зв’язку: повідомлення називає шаблон, ключ provides, компонент-споживач, що читає його зі свого з’єднання на сокеті, і компонент-виробник. Копіюйте значення як є, цілим або всередині довшого рядка, бо провайдер записує на його місце те, чим значення стає в іншому виході, а розгалуження будуйте на власному значенні компонента)

Як виправити: копіюйте значення, назване в повідомленні, а не перевіряйте й не перетворюйте його, і ухвалюйте рішення на основі значення, яке компонент-споживач задає сам, — одного з власних ключів values або infra, — а не того, що читає його з’єднання. В описі провайдера CloudFormation пояснено, чим скопійоване значення стає в іншому стеку.

A provider named a directory for a contributor that is not one directory (Провайдер указав для учасника каталог, який не є одним каталогом)

Провайдер, який розміщує кожного учасника на власній позиції всередині одного спільного результату, оголошує каталог, у якому розташовані ці позиції, і збірка вкладає в нього ідентичність кожного компонента. Значення має називати рівно один каталог: значення з роздільником шляху або таке, що називає поточний чи батьківський каталог, розмістило б файли компонента не під його власною позицією — або взагалі поза збіркою, або непомітно переставленими всередині неї.

Збірка зупиняється, а не складає такий шлях. Повідомлення називає провайдера, який оголосив значення, і саме значення, тож зрозуміло, якого провайдера змінювати і що він оголосив.

Провайдера, який не оголошує такого каталогу, це не стосується. Тоді кожен учасник розташовується безпосередньо в каталозі розгортання під власним іменем, тож відмова називати спільний каталог — це законна відповідь, а не пропуск.

Повідомлення, що виводиться:

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 (провайдер указав для власного підкаталогу кожного учасника каталог, що не є одним іменем каталогу: провайдер оголосив nest_segment; значення має називати один каталог, не містити роздільника шляху й не називати ні поточного, ні батьківського каталогу)

Як виправити: жоден документ каталогу не створює цього значення, тож у ваших файлах нічого виправляти — воно походить від плагіна, що обслуговує провайдера. Повідомте про це того, хто публікує цей плагін, процитувавши значення з повідомлення. Якщо плагін ваш, оголосіть одне ім’я каталогу або не оголошуйте жодного, і тоді кожен учасник розташується в каталозі розгортання.

A boundary-scope Feature is attached only to a component (Feature з областю межі приєднано лише до компонента)

FeatureRecipe може оголосити, що генерується один раз для межі, а не один раз для кожного компонента, — один спільний ресурс для всього, що містить межа, замість одного на компонент. Тому саме на межі слід записувати таке приєднання: приєднання з цим іменем, записане лише для компонента, не задає області, для якої рецепт міг би генерувати, тож ніщо не визначає, на якій межі він виконувався б, які значення читав би і куди записувався б його результат.

Запис його також на компоненті є звичайним і не повідомляється. Приєднання, оголошене на межі, досягає кожного компонента, який містить ця межа, зокрема й тих, що в областях, вкладених у неї, тож його наявність — нормальна форма. Перевіряється, чи оголошує це ім’я власна область компонента або одна з охопних областей, — пошук іде назовні від місця компонента й зупиняється на першій області, яка його оголошує. Компонент, що повторює на собі приєднання, яке вже оголошує його охопна область, рендериться точно так само, як і форма лише з областю, і допускається з тієї самої причини.

Компонентові, не розміщеному в жодній області, нема чим пройти назовні, тож про приєднання з областю межі на ньому повідомляється тут — і це чесне тлумачення, бо немає області, для якої такий рецепт міг би генерувати.

Повідомлення, що виводиться, із назвою приєднання та області, в якій розташований компонент:

attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>", on a component in boundary "<boundary>") (приєднання прив’язує FeatureRecipe з executionScope: boundary, але жодна межа, що містить компонент, його не оголошує: приєднання на компоненті в межі)

а для компонента поза будь-якою областю, який такого значення не дає:

attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>") (приєднання прив’язує FeatureRecipe з executionScope: boundary, але жодна межа, що містить компонент, його не оголошує)

Як виправити: оголосіть приєднання в features: на межі, для якої воно має генерувати, — в області, де розташований компонент, або в охопній, — а не лише на компоненті. Якщо ви мали на увазі генерацію для кожного компонента, натомість приєднайте Feature, чий FeatureRecipe не оголошує області межі.

Пісочниця відхилила плагін

Кожен плагін повідомляє, що він таке і що йому потрібно, перш ніж йому дозволять виконувати будь-яку роботу, і пісочниця звіряє цей звіт із тим, що вона готова надати. Ця умова охоплює весь клас звітів, яких пісочниця не приймає, а речення повідомлення вказує, яку саме частину звіту відхилено: версію інтерфейсу плагінів, якою хост не володіє; вид плагіна, для якого хост не має словника; плагін, що просить вихідного мережевого доступу або доступу до файлової системи; плагін, що називає виклик хоста поза набором, який хост пропонує, або імпортує з простору імен поза набором, який хост допускає; відсутній або некоректний експорт; поле зі значенням поза закритим набором, дозволеним для нього; або самозвіт, який узагалі неможливо прочитати.

Відхилення відбувається до запуску плагіна, а відхилений плагін зупиняється ще до того, як помилка поширюється далі, тож нічого з того, що він просив, не надається навіть на мить.

Частина того, чого плагін не може мати, тут не перевіряється, бо її ніколи не надають. Хост дає гостю заморожений годинник, жодної файлової системи, жодного середовища і жодного місця для власного виводу, тож гість, який намагається дістатися до будь-чого з цього, зазнає невдачі під час спроби, а не відхиляється заздалегідь. Ця умова охоплює звіт, який плагін робить про себе, і перевіряється до його запуску.

Повідомлення, що виводяться. Кожне завершується реченням умови, а те, що йому передує, називає плагін і відхилену частину його звіту. Версія інтерфейсу, якою хост не володіє:

plugin "<plugin>" declares abi_version "<declared>"; host speaks "<supported>": wasm: plugin rejected by the sandbox (плагін оголошує abi_version; хост підтримує іншу: wasm: плагін відхилено пісочницею)

вид плагіна, для якого хост не має словника:

plugin "<plugin>" declares unknown plugin_type "<declared>": wasm: plugin rejected by the sandbox (плагін оголошує невідомий plugin_type: wasm: плагін відхилено пісочницею)

самозвіт, який неможливо прочитати:

wasm: plugin "<plugin>" describe() output is not valid JSON: <what the read reported>: wasm: plugin rejected by the sandbox (wasm: вивід describe() плагіна не є коректним JSON: wasm: плагін відхилено пісочницею)

плагін без експорту, якого вимагає його вид, названий за тим самим реєстром, з якого читається сам вид:

<kind> plugin "<plugin>" declares no "<export>" export: wasm: plugin rejected by the sandbox (плагін не оголошує експорту: wasm: плагін відхилено пісочницею)

поле, закрите фіксованим набором, містить щось інше — та сама форма охоплює режим збирання, а також поля operates і scope кожного експорту:

plugin "<plugin>" export "<export>" declares unknown scope "<declared>" (want "own", "host", or empty): wasm: plugin rejected by the sandbox (експорт плагіна оголошує невідомий scope (очікується own, host або порожнє значення): wasm: плагін відхилено пісочницею)

парну можливість оголошено без обох її експортів або експорти — без заявки на можливість:

plugin "<plugin>" declares the cross-boundary linking capability but does not export both "link_publish" and "link_resolve": wasm: plugin rejected by the sandbox (плагін оголошує можливість зв’язування між межами, але не експортує обидва link_publish і link_resolve: wasm: плагін відхилено пісочницею)

назва можливості, яку Recipe ніколи не зможе вибрати, — provider, що обслуговує назву з двокрапкою, або крок конвеєра, сумісний з такою назвою, — бо capability: у Recipe читається як назва до останньої двокрапки і закріплення версії після неї. parse:<format> парсера та import:<format> імпортера не відхиляються: двокрапка є частиною цих назв, і їх шукають за форматом, а не через Recipe. Те саме відхилення не дає згенерувати сутність такого плагіна для публікації:

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 (плагін обслуговує можливість, назва якої містить двокрапку; посилання Recipe на можливість читається як можливість до останньої двокрапки і закріплення версії після неї, тож жоден Recipe не може її назвати: повідомляйте назву можливості без двокрапки: wasm: плагін відхилено пісочницею)

і виклики хоста, які заявляє плагін, звіряються з тими, що справді використовує його бінарний файл; перевірка відбувається в обох напрямках, тож плагін не може ні рекламувати поверхню, якою не користується, ні приховати ту, якою користується:

plugin "<plugin>" declares host function "<name>" in describe() that its wasm does not import: wasm: plugin rejected by the sandbox (плагін оголошує в describe() функцію хоста, яку його wasm не імпортує: wasm: плагін відхилено пісочницею) plugin "<plugin>" imports host function "<name>" that its describe() does not declare: wasm: plugin rejected by the sandbox (плагін імпортує функцію хоста, яку його describe() не оголошує: wasm: плагін відхилено пісочницею)

Як виправити: ніщо у ваших файлах сутностей цього не спричиняє, і жодна зміна в авторських файлах цього не усуне — відхилено власний звіт плагіна. Якщо ви використовуєте опублікований плагін, повідомте про помилку тому, хто його публікує, а тим часом виберіть версію, яку хост приймає. Якщо плагін ваш, повідомлення називає поле й обидва значення, тож виправлення таке, на яке вказує речення: використовуйте версію інтерфейсу, якою володіє хост, оголошуйте відомий йому вид, тримайте кожне поле в межах його закритого набору, оголошуйте експорт, якого вимагає ваш вид, і оголошуйте рівно ті виклики хоста, які використовує ваш бінарний файл, — не більше й не менше.

Плагін не того виду, на який очікує сокет

Кожна точка підключення вказує, якого виду плагін вона викликає, і кожен плагін повідомляє свій власний вид. Ця умова повідомляє про розбіжність між ними: плагін, що обслуговує provider, підключено там, де очікується лінтер; парсер підключено там, де очікується імпортер; плагін, який не є термінальною командою, запущено як таку. Перевірка відбувається під час завантаження плагіна, тож плагін не того виду ніколи не доходить до роботи, яку йому мали б доручити.

Збирання зупиняється, а не пробує попри все, тому що різні види не мають спільного інтерфейсу. Плагін іншого виду викликався б через експорти, яких він не має, а те, що він повернув би, читалося б за формою, якої він ніколи не створював.

Читання самозвіту плагіна без вимоги щодо виду не зачіпається. Поверхня, якій потрібно лише знати, що плагін каже про себе, — перелік налаштованого, генерування сутності для плагіна — не висуває очікувань, і там ця перевірка пропускається.

Повідомлення, що виводиться, називає плагін і обидва види, причому очікуваний вид подано і словами, і його оголошеним значенням:

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: очікувався плагін іншого виду, але його describe() повідомляє інший тип плагіна: wasm: оголошений тип плагіна не відповідає describe() плагіна)

Як виправити: підключіть плагін того виду, який приймає точка підключення, — повідомлення називає очікуваний вид. Якщо плагін саме той, що ви мали на увазі, підключення стоїть не на своєму місці: перенесіть його на поверхню, до якої належить його вид. Якщо ви автор плагіна і він має бути очікуваного виду, то він повідомляє про себе не той вид, і виправляти слід плагін, а не конфігурацію, яка його підключає.

Плагін зазнав збою під час виконання

Плагін, якого попросили щось зробити, не повернув результату. Цей випадок охоплюють три умови, і відрізняє їх лише те, як поширився збій: плагін аварійно завершився, плагін сам зупинив своє виконання або плагін виконався до кінця й повідомив, що не може зробити те, що просили. Їх навмисно об’єднано в одну таксономію, щоб збірка однаково обробляла кожен спосіб, у який плагін може зазнати збою.

Плагін аварійно завершився. Більшість збоїв усередині плагіна — недосяжна інструкція, ділення на нуль, читання поза його пам’яттю — на виході перетворюються на звичайні збої й ніколи не доходять до цієї умови. Вона є страховкою за цим шляхом — для аварії, яка його оминає.

Плагін сам зупинив своє виконання. Плагін, що просить завершитися, робить те, для чого модель плагінів не має застосування: плагін повертає результат через виклик, яким його викликали, а не завершенням. Зупиняється лише його власне виконання; процес збірки не зачіпається.

Плагін повідомив про збій. Конверт результату, який повертає плагін, має місце, щоб повідомити, що виконати не вдалося, і таке повідомлення передається далі як збій, а не читається як результат.

Повідомлення, що виводяться, кожне з яких називає плагін або експорт і містить усе, що надав збій. Аварія містить відновлене значення:

wasm: guest plugin "<plugin>" panicked in <export>: <the recovered value>: wasm: guest plugin panicked during call (wasm: гостьовий плагін панікував у: : wasm: гостьовий плагін панікував під час виклику)

плагін, що сам зупинився, містить код, з яким він зупинився:

wasm: plugin "<plugin>" call to <export> invoked proc_exit(<code>): wasm: plugin invoked proc_exit (wasm: виклик плагіна до викликав proc_exit(): wasm: плагін викликав proc_exit)

а повідомлений збій містить власне повідомлення плагіна:

call "<export>": wasm: guest plugin reported an error: <the plugin's message> (виклик : wasm: гостьовий плагін повідомив про помилку:)

Як виправити: жодна з трьох умов не спричинена вашими файлами сутностей, і жодна зміна в них її не усуне — кожна є збоєм усередині плагіна. Повідомте про це тому, хто публікує плагін, назвавши експорт, який указано в повідомленні, і закріпіть плагін на версії, що працювала, доки його виправляють. Якщо плагін ваш: повертайте збій у конверті результату, а не аварійно завершуйтеся чи виходьте, щоб збірка отримала повідомлення, яке можна показати; а якщо повідомлений збій є обдуманою відповіддю самого плагіна, його повідомлення побачить читач, тож варто сказати, що саме у вхідних даних не вдалося прийняти.

A plugin returned something that is not the shape the socket reads (Плагін повернув щось, що не має форми, яку читає гніздо)

Кожна точка підключення перевіряє отриманий результат на відповідність очікуваній формі й відхиляє все інше — поле, якого форма не оголошує, поле, значення якого не має оголошеного для нього типу, або байти, що взагалі не є коректно сформованим результатом.

Вона відхиляє результат, а не читає те, що може, бо таке читання було б непомітним. Який експорт викликає підключення, можна вибрати для кожного підключення окремо, тож підключення може назвати експорт, результат якого має зовсім іншу форму. Пропуск частин, що не підходять, дає порожній результат — а порожній результат сам по собі є законною відповіддю: вердикту не повернуто, знахідок не виявлено. Тоді ці два випадки неможливо було б розрізнити, і збірка тривала б так, ніби плагін її схвалив.

Повідомлення, що виводиться, називає експорт, з якого повернувся результат, і містить причину, з якої читання не вдалося, — разом вони вказують на експорт, який мало б назвати підключення:

call "<export>": wasm: guest plugin returned an output that is not the shape the socket reads: <what could not be read> (виклик : wasm: гостьовий плагін повернув вивід, що не має форми, яку читає гніздо:)

Як виправити: звірте функцію входу, яку називає підключення, з експортами, які оголошує плагін, — підключення, спрямоване на неправильний експорт, є поширеною причиною, а причина в повідомленні називає поле, якого там не має бути. Якщо експорт правильний, плагін повертає форму, яку точка підключення не читає, і це потребує виправлення в плагіні; повідомте про це тому, хто його публікує, навівши і експорт, і причину.

A plugin returned a diagnostic at a severity that is not declared (Плагін повернув діагностику з неоголошеним рівнем серйозності)

Плагін може повертати спостереження разом зі своїм результатом, і кожне має рівень серйозності із закритого набору: один зупиняє збірку й називає, що виправити, другий показується поруч зі збіркою, яка все одно завершується, а третій записує спостереження й нічого не змінює. Для рівня поза цим набором хост не має маршруту, і збірка зупиняється.

Хост відхиляє його, а не вибирає маршрут, бо обидві альтернативи гірші. Пропуск спостереження, яке неможливо спрямувати, означав би вважати, що робити нічого не треба, — а там, де плагін вирішує, чи приймати збірку, це читається як схвалення: заперечення, висунуте плагіном, пропустило б збірку, так і не бувши показаним. Трактування його як зупинного рівня відхилило б збірку через значення, якого ніхто не обирав. Обидва варіанти непомітні, тому хост повідомляє, що значення неправильне, і натомість виправляють плагін.

Перевірка виконується один раз, там, де читається результат, а не в кожному місці, де спостереження згодом показується, — і це також єдина точка, де ідентичність плагіна ще відома, адже спостереження, включене у звіт, уже не знає, який плагін його висунув.

Повідомлення, що виводиться, називає плагін, експорт, яке спостереження було помилковим, його значення та оголошені значення:

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" (плагін виклик : wasm: гостьовий плагін повернув діагностику, рівень серйозності якої контракт не оголошує: діагностика має рівень серйозності; оголошені рівні серйозності — , і )

Як виправити: це не спричинено вашими файлами сутностей — значення надійшло від плагіна. Повідомте про це тому, хто публікує плагін, навівши значення, указане в повідомленні. Якщо плагін ваш, виводьте один із трьох оголошених рівнів серйозності; повідомлення їх називає, а індекс указує, яке спостереження перевірити.

A provider returned two output files under one path (Провайдер повернув два вихідні файли за одним шляхом)

Провайдер повертає свій вивід як список файлів, кожен з яких називає шлях, за яким його записують. Хост збирає їх за ключем-шляхом і записує байти кожного файлу дослівно, не запускаючи власного серіалізатора. Два файли з однаковим шляхом лишають у цій колекції два значення для одного ключа.

Хост відхиляє їх, а не вибирає один, бо згодом жоден вибір неможливо відрізнити від іншого. Збереження останнього відкидає файл, який провайдер наказав записати; збереження першого відкидає пізніший. У будь-якому разі вивід на диску коректно сформований і має на один файл менше, і ніщо не фіксує, що файл було відкинуто, — а шлях, що вцілів, вцілів би й так, тож ніщо в результаті не свідчить про колізію. Який із двох малося на увазі — питання, на яке може відповісти лише провайдер.

Ця умова виникає всюди, де провайдер повертає файли: під час рендерингу одного вузла та під час складання виводу групи диспетчеризації в один артефакт. Умова й виправлення в обох випадках однакові, тому про неї повідомляють обидва.

Повідомлення, що виводиться, називає шлях, повернутий двічі, і вузол або шлях диспетчеризації, для якого його повернуто:

provider guest returned two output files under one path; a conforming guest returns each output path at most once (path "<path>", node "<node>") (гостьовий провайдер повернув два вихідні файли за одним шляхом; сумісний гість повертає кожен вихідний шлях щонайбільше один раз)

Як виправити: це не спричинено вашими файлами сутностей — шляхи надійшли від провайдера. Повідомте про це тому, хто його публікує, навівши шлях, указаний у повідомленні. Якщо провайдер ваш, повертайте кожен вихідний шлях щонайбільше один раз: будуйте список шляхів із перевіркою за множиною, щоб другий файл за тим самим шляхом виявлявся там, де його створено, і дайте другому файлу окремий шлях, якщо потрібні обидва.

A provider reported a render fact whose value is not a list (Провайдер повідомив факт рендерингу, значення якого не є списком)

Провайдер може разом зі своїми файлами повідомляти факти про відрендерений вивід — кожен має ім’я та значення у власному задокументованому словнику цього провайдера, — а Features, приєднані до компонента, читають їх зі своїх шаблонів. Значення кожного факту — список, навіть коли він містить один елемент: одне ім’я може бути повідомлене кількома рендерингами компонента — викликами його власного провайдера та рендерингами приєднаних до нього Features, — і для шаблонів, що його читають, списки об’єднуються в один під цим ім’ям. Під час рендерингу провайдер не може знати, чи буде його повідомлення єдиним під певним ім’ям, тому значення, що є об’єктом, рядком, числом, булевим значенням або null, відхиляється там, де провайдер його передає, для кожного рендерингу, незалежно від того, чи читає цей факт якийсь шаблон.

Повідомлення, що виводиться, називає факт, вузол, для якого його повідомлено, провайдера, який його повідомив, і яким було значення:

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>) (гостьовий модуль провайдера повідомив факт рендерингу, значення якого не є списком; відповідний вимогам гостьовий модуль повідомляє значення кожного факту рендерингу як масив JSON, навіть з одним елементом (факт, вузол, провайдер, його значення))

Як виправити: ніщо у ваших файлах сутностей цього не спричиняє — значення надійшло від провайдера. Повідомте про це тому, хто його публікує, навівши факт, названий у повідомленні. Якщо провайдер ваш, повідомляйте значення цього факту як масив JSON — окремий об’єкт стає списком, що містить цей об’єкт, — і задокументуйте його як список серед фактів, які повідомляє ваш провайдер; див. Повідомлення фактів про те, що вивів гостьовий модуль.

Коли з’єднання перетинає межу між двома групами диспетчеризації, провайдера з кожного боку просять його під’єднати: споживаний кінець публікує ідентичність, споживчий кінець розв’язується відносно неї, і кожен може повернути структурне з’єднання, яке слід застосувати до виводу власної групи. Кожен фрагмент з’єднання називає вихідний файл, до якого він застосовується. Пізніший прохід розрізає цей файл, застосовує операції та збирає його назад байт у байт.

Ім’я, що не збігається з жодним виведеним файлом, не залишає цьому проходу нічого для розрізання, і він відмовляє, а не пропускає з’єднання. Операції, які воно несе, — це те, що розв’язує з’єднання, тож їх відкидання залишає зібраний вивід із посиланням на кінцеву точку, яку ніхто не під’єднав, — що дає збій під час розгортання, далеко від провайдера, який його спричинив, і виглядає як помилка у з’єднанні, а не у під’єднанні.

Файли, які може називати фрагмент з’єднання, — це файли, які повернув власний рендеринг цієї групи. Їх передають провайдеру в тому самому виклику, тож провайдеру ніколи не доводиться вгадувати ім’я: він вибирає одне з наданого набору.

Повідомлення, що виводиться, називає файл, якого вимагало з’єднання, і кінцеву точку, для якої його повернуто:

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>") (латка зв’язку називає вихідний файл, який група диспетчеризації не виводила; відповідна вимогам латка зв’язку називає файл, який повернув власний рендеринг групи (файл, вузол))

Як виправити: ніщо у ваших файлах сутностей цього не спричиняє — ім’я надійшло від провайдера. Повідомте про це тому, хто його публікує, навівши файл, названий у повідомленні. Якщо провайдер ваш, називайте файл із зібраних файлів, які вам передає виклик, а не за ім’ям, побудованим незалежно, — шлях, складений вручну, застаріває щойно змінюється рендеринг, що його створює, і саме так це виглядає.

A pipeline step’s file emission carries no file (Виведення файлу кроком конвеєра не містить файлу)

Крок конвеєра може виводити новий документ поряд із тими, які він латає. Кожне виведення оголошує свій вид, а виведення виду «файл» містить файл, який воно записує: шлях і вміст.

Тут вид правильний, а файл відсутній, тож крок оголосив намір, який його відповідь не виконує. У цьому відмінність від зупинки через невизначений вид нижче: хост точно знає, що робити з виведенням emit_file, але не має, до чого це застосувати.

Він відмовляє, а не виводить нічого, бо виведення, яке непомітно не додало жодного файлу, було б невидимим. Крок, що виводить документ, часто є єдиною причиною, чому він є в конвеєрі, а його вивід — файл, якого раніше не було, тож збірка, яка його пропустила б, створила б вивід без документа, а крок повідомив би, що виконався.

Повідомлення, що виводиться, називає вузол і те, яке з виведень кроку було помилковим:

emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and content (node "<node>", side effect <index>) (побічний ефект emit_file не містить файлу; відповідний вимогам побічний ефект emit_file містить файл із його шляхом і вмістом (вузол, побічний ефект))

Як виправити: ніщо у ваших файлах сутностей цього не спричиняє — відповідь надійшла від плагіна. Повідомте про це тому, хто його публікує, навівши індекс, названий у повідомленні. Якщо плагін ваш, заповнюйте член file у кожному виведенні emit_file, і шляхом, і вмістом; індекс указує, яке виведення у відповіді цього кроку слід переглянути.

A pipeline step declares an emission kind the contract does not define (Крок конвеєра оголошує вид виведення, який контракт не визначає)

Кожне виведення, яке повертає крок конвеєра, оголошує свій вид, і контракт визначає два: один записує файл, другий додає документ користувацького ресурсу. У протоколі вид є відкритим рядком, що й дає змогу додати пізніший вид, не ламаючи наявних плагінів.

Саме ця відкритість і є причиною, чому невизначений вид відхиляється, а не пропускається. Значення, яке хост не визначає, за самою формою неможливо відрізнити від того, яке визначить пізніша версія, — тож хост, що його пропустив би, мовчки відкидав би все, що крок ним мав на увазі, у кожній збірці, тоді як крок повідомляв би про успіх. Відмова зберігає точку розширення відкритою, не роблячи її дірою: вид, який ця збірка не визначає, повідомляється як невизначений із наведенням значення, яке надіслав крок, а не приймається та ігнорується.

Повідомлення, що виводиться, називає вузол, яке виведення було помилковим, і вид, який воно оголосило:

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>") (побічний ефект оголошує вид, який контракт плагіна не визначає; відповідний вимогам побічний ефект оголошує emit_file або emit_crd (вузол, побічний ефект, вид))

Як виправити: ніщо у ваших файлах сутностей цього не спричиняє — значення надійшло від плагіна. Повідомте про це тому, хто його публікує, навівши вид, названий у повідомленні. Якщо плагін ваш, оголошуйте один із видів, перелічених у повідомленні; поширена причина — помилка в написанні визначеного виду, а наведене у відповідь значення — це те, що ви надіслали.

Повторне складання провайдера отримує одиницю, якої не створило його власне розрізання

Провайдер, форму виводу якого не можна адресувати напряму, може розрізати його самостійно: він ділить вихідний файл на адресовані одиниці, кожну під своїм токеном, і повертає їх. Потім крок конвеєра адресує одиницю за цим токеном, а повторне складання вставляє відредаговані одиниці назад у файл з точністю до байта. Обидві половини становлять один контракт: токени, під якими розрізано файл, — це ті самі токени, які розв’язує його повторне складання.

Коли повторне складання отримує токен, якого не створило розрізання того самого файлу, для відредагованого вмісту немає діапазону байтів, куди його повернути. Воно відмовляє, а не відкидає одиницю, бо відкинута одиниця дає файл, що є коректним і водночас не містить редагування, яке крок мав зробити: нічого не впало, нічого не зіпсовано, а редагування просто відсутнє.

Дві половини можуть розійтися лише там, де їх розділено, — у кодеку, що розрізає самостійно, а для решти запозичує стандартне структурне повторне складання. Тоді розрізання під одним набором токенів і повторне складання за іншим дає саме це. Кодек, якому належать обидві половини, сюди не потрапить: його власне повторне складання відповідає за його власні токени.

Повідомлення, що виводиться, називає токен, який ні на що не розв’язався, і файл, щодо якого його було названо:

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>") (повторне складання називає токен змінної одиниці, якого не створило розрізання; сумісний кодек розрізає і повторно складає файл під тими самими токенами (токен, файл))

Як виправити: ніщо у ваших файлах сутностей цього не спричиняє. Якщо провайдер ваш, зробіть так, щоб токени, які створює одна половина, були токенами, які розв’язує інша: виводьте їх один раз і передавайте далі, а не виводьте незалежно з кожного боку, а якщо розрізання переписує файл перед поділом, виконуйте повторне складання за тією самою переписаною формою. Якщо провайдер не ваш, повідомте про це тому, хто його публікує, навівши токен, названий у повідомленні.

Робоче навантаження оголошує форму, яку compose не може виразити

Провайдер compose рендерить довготривалі сервіси. Робоче навантаження, яке оголошує, що запускається однією копією на машину, за розкладом або один раз до завершення, не має чистого одномашинного еквівалента, тому рендеринг зупиняється, а не виводить звичайний сервіс, який би запустив його, тримав запущеним і неправильно відобразив те, що було запитано.

Повідомлення, що виводиться. Умова називає вид збою — провайдер не має виразу для чогось, що оголошує збірка, — а власне речення провайдера називає форму, яку він отримав:

a plugin has no expression for a construct this build declares compose: workload form "<form>" has no compose mapping; compose supports stateless and stateful only: compose cannot express this workload form (плагін не має виразу для конструкції, яку оголошує ця збірка; compose: форма робочого навантаження не має відповідника в compose; compose підтримує лише stateless і stateful: compose не може виразити цю форму робочого навантаження)

Як виправити: якщо ціль справді є одномашинним середовищем compose, виразіть роботу як довготривалий сервіс — форми stateless і stateful є двома, які він рендерить. Якщо ви мали на увазі саме цю форму, рендерте цю межу через провайдера, ціль якого має еквівалент: копія на машину, запуск за розкладом і завдання до завершення мають прямі вирази деінде, а вибір провайдера належить межі, а не робочому навантаженню.

Контейнер оголошує поле, для якого в compose немає примітиву

Два поля контейнера не мають еквівалента в compose, і обидва зупиняють рендеринг, а не відкидаються.

Хуки, що запускаються, коли контейнер стартує або от-от зупиниться. У compose немає нічого, що їх запускає, а хук, який непомітно не запускається, — це несподіванка щодо коректності, що виявляється під час виконання, а не під час збірки.

Масове середовище, взяте з іменованого об’єкта. compose може читати змінні з файлу, але посилання на об’єкт не є файлом — тлумачення одного як іншого непомітно змінило б те, що отримує контейнер.

Обидва перевіряються для звичайних контейнерів і для контейнерів, що запускаються перед основним, тож те саме поле зупиняє збірку, де б його не було оголошено, а повідомлення називає контейнер, з якого воно походить.

Повідомлення, що виводяться. Обидва повідомляють ту саму умову — провайдер не має виразу для чогось, що оголошує збірка, — а власне речення провайдера вказує, яке це поле:

a plugin has no expression for a construct this build declares 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: вузол, контейнер: compose: вузол оголошує хуки життєвого циклу контейнера; у compose немає примітиву хуків життєвого циклу)

a plugin has no expression for a construct this build declares 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: вузол, контейнер: compose: вузол оголошує envFrom контейнера; у compose немає примітиву середовища з об’єкта)

Як виправити: для цілі compose видаліть поле й виконайте його роботу інакше — роботу під час запуску слід виконувати в контейнері, що запускається перед основним, а роботу під час зупинки — у власній обробці сигналів контейнера; масове середовище можна виписати як явні змінні або передати з файлу, який може прочитати ціль compose. Якщо ви мали на увазі саме це поле, рендерте цю межу через провайдера, ціль якого має такий примітив.

Запис omits називає вид або простір імен, яких немає у файлі compose

Запис omits: у Recipe або FeatureRecipe, що бере за джерело файл compose, виключає одну одиницю верхнього рівня цього файлу, а файл compose має рівно три види, які може назвати запис, — service, volume і config, кожен під ключем у services:, volumes: або configs:, — і не має просторів імен. Запис, що називає будь-який інший вид, зокрема Secret документа чарту чи network compose, або містить namespace, не називає нічого, що файл міг би виключити, тому рендеринг зупиняється, а не вважає запис таким, що ні з чим не збігся. Види порівнюються точно, тож Service відхиляється там, де мається на увазі service. Кожен запис перевіряється до того, як щось буде виключено, і називається перший помилковий у порядку, в якому записи написано.

Повідомлення, що виводяться. Обидва повідомляють умову для конструкції, для якої провайдер не має виразу, а власне речення провайдера називає запис і види, які він приймає. Поле, шаблон якого прочитав значення, оголошене чутливим, показується як <redacted>:

a plugin has no expression for a construct this build declares 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: запис omits (ім’я) називає вид; compose виключає service, volume або config, кожен названий своїм ключем у services:, volumes: або configs:, і жодного іншого виду)

a plugin has no expression for a construct this build declares 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: запис omits (вид, ім’я) називає простір імен, а файл compose не має просторів імен; compose виключає service, volume або config, кожен названий своїм ключем у services:, volumes: або configs:, і жодного іншого виду; видаліть простір імен із запису)

Як виправити: називайте одиницю так, як це робить файл compose, — kind: service, volume або config, а name: — її ключ у цьому розділі, — і приберіть namespace:. Див. compose → Режим із джерелом.

Запис omits називає простір імен, якого немає в шаблоні CloudFormation

Запис omits: у сутності Recipe або FeatureRecipe, що бере за джерело шаблон CloudFormation, вилучає один ресурс, названий його Type як kind запису та його логічним ID як name запису. Шаблон не має просторів імен, тож запис, що містить namespace, не називає нічого, що шаблон міг би вилучити, і рендеринг зупиняється, а не вважає цей запис таким, що нічому не відповів. Кожен запис перевіряється до того, як щось буде вилучено, і названо буде перший запис із простором імен у порядку, в якому записи написано.

Повідомлення, що виводиться. Воно повідомляє про умову для конструкції, яку провайдер не може виразити, а власне речення провайдера називає запис і те, що вилучає цей провайдер. Поле, шаблон якого прочитав значення, оголошене чутливим, показується як <redacted>:

a plugin has no expression for a construct this build declares cloudformation-provider: an omits entry (kind "<kind>", name "<name>") names namespace "<namespace>", and a CloudFormation template has no namespaces: cloudformation leaves out a resource, named by its Type as the entry’s kind and its logical ID under Resources as the entry’s name; remove the namespace from the entry (плагін не може виразити конструкцію, яку оголошує ця збірка; cloudformation-provider: запис omits (kind, name) називає простір імен, а шаблон CloudFormation не має просторів імен: cloudformation вилучає ресурс, названий його Type як kind запису та його логічним ID у Resources як name запису; приберіть простір імен із запису)

Як виправити: приберіть namespace: із запису, який називає ресурс лише його Type і логічним ID. Див. cloudformation → Вилучення ресурсів із шаблону-джерела.

Опублікований порт оголошує транспорт, який compose не може записати

Опублікований порт compose несе свій транспорт як суфікс запису, і цей суфікс має два написання. Порт, що оголошує будь-який інший транспорт, не має жодного написання в compose.

Збірка зупиняється, а не відкидає суфікс, бо опублікований порт, що непомітно повертається до транспорту за замовчуванням, запускається з трафіком, якого його клієнти не можуть досягти, — саме той збій, для запобігання якому існує оголошення транспорту, знову привнесений у момент перетворення.

Порт, що не оголошує транспорту, це не зачіпає. Він публікується без суфікса, так само як порт, що ніколи не мав транспорту.

Повідомлення, що виводиться. Умова називає вид збою — значення, яке не має представлення в тому, що виводить провайдер, — а за нею йде власне речення провайдера:

a plugin has no representation for a value it was given compose: node "<node>" apply service ports: compose publishes a port’s transport as a tcp or udp suffix; this port declares a transport compose cannot express (плагін не має представлення для отриманого значення; compose: вузол, застосування портів сервісу: compose публікує транспорт порту як суфікс tcp або udp; цей порт оголошує транспорт, який compose не може виразити)

Як виправити: для цілі compose оголосіть транспорт порту як один із двох, які compose може записати, або залиште його неоголошеним, щоб запис публікувався без суфікса. Якщо ви мали на увазі саме цей транспорт, рендерте цю межу через провайдер, ціль якого може його виразити.

Кількість ресурсів не можна перетворити на значення compose

Кількості процесора й пам’яті контейнера, а також його кількість nvidia.com/gpu, записуються в нотації, яку Kubernetes використовує для ресурсів, а compose зберігає їх у власних одиницях — кількість GPU стає кількістю в резервуванні пристроїв NVIDIA, — тож кожну з них читають як кількість і перетворюють із її значення. Дві речі цьому заважають, і повідомлення каже, яку з них виявлено: значення, що взагалі не є кількістю, і кількість, для якої compose не має точної форми, — від’ємна величина, обсяг пам’яті, що не є цілим числом байтів, обсяг процесора, точніший за дев’ять десяткових знаків ядра, кількість GPU, що не є цілим числом пристроїв, або величина, більша за найбільшу, яку може вмістити compose. Контейнер, запит і ліміт nvidia.com/gpu якого вимагають різних кількостей, також зупиняє збірку, бо compose резервує для сервісу одну кількість. Збірка зупиняється, а не округлює значення чи виводить наближення, бо ліміт, який непомітно відрізняється від запитаного, — це та відмінність, яку ніхто не шукає, доки щось не зупинять за його перевищення.

Повідомлення, що виводяться. Кожне починається з умови — значення, яке не має представлення в тому, що виводить провайдер, — потім називає ресурс, чи є значення запитом або лімітом, його шлях у сутності Workload і саме значення. Після значення, що не є кількістю, йде те, чому воно нею не є, і форма, яку має кількість:

a plugin has no representation for a value it was given compose: node "<node>" container "<container>": compose: the <cpu|memory|nvidia.com/gpu> <request|limit> at <path>: "<value>" is not a quantity: <reason>; a quantity is a number such as 2, 0.5 or 1.5, with an optional sign and at most one of an integer exponent (1e3, 5E-2) or a unit suffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei): resources quantity cannot be converted to a compose deploy.resources value (плагін не має представлення для отриманого значення; compose: вузол, контейнер: compose: запит або ліміт за шляхом не є кількістю; кількість — це число, наприклад 2, 0.5 або 1.5, з необов’язковим знаком і щонайбільше одним із цілого показника степеня (1e3, 5E-2) або суфікса одиниці (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei): кількість ресурсів не можна перетворити на значення deploy.resources у compose)

Після кількості, яку compose не може представити, йде діапазон, який compose має для цього ресурсу:

a plugin has no representation for a value it was given compose: node "<node>" container "<container>": compose: the memory <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose memory value is a whole number of bytes from 0 to 9223372036854775807: resources quantity cannot be converted to a compose deploy.resources value (плагін не має представлення для отриманого значення; compose: вузол, контейнер: compose: запит або ліміт пам’яті за шляхом — кількість, яку compose не може точно представити; значення пам’яті в compose — ціле число байтів від 0 до 9223372036854775807: кількість ресурсів не можна перетворити на значення deploy.resources у compose)

a plugin has no representation for a value it was given compose: node "<node>" container "<container>": compose: the cpu <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose cpus value is a core count from 0 to 9223372036.854775807 with at most nine decimal places: resources quantity cannot be converted to a compose deploy.resources value (плагін не має представлення для отриманого значення; compose: вузол, контейнер: compose: запит або ліміт процесора за шляхом — кількість, яку compose не може точно представити; значення cpus у compose — кількість ядер від 0 до 9223372036.854775807 щонайбільше з дев’ятьма десятковими знаками: кількість ресурсів не можна перетворити на значення deploy.resources у compose)

a plugin has no representation for a value it was given compose: node "<node>" container "<container>": compose: the nvidia.com/gpu <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose device count is a whole number of devices from 0 to 9223372036854775807: resources quantity cannot be converted to a compose deploy.resources value (плагін не має представлення для отриманого значення; compose: вузол, контейнер: compose: запит або ліміт nvidia.com/gpu за шляхом — кількість, яку compose не може точно представити; кількість пристроїв у compose — ціле число пристроїв від 0 до 9223372036854775807: кількість ресурсів не можна перетворити на значення deploy.resources у compose)

Запит і ліміт GPU, що вимагають різних кількостей, називають обидва шляхи й обидві кількості:

a plugin has no representation for a value it was given compose: node "<node>" container "<container>": compose: the nvidia.com/gpu request at <path> and the limit at <path> ask for different counts (<request> and <limit>); compose reserves one device count for a service, so write the same count in both or only the limit: resources quantity cannot be converted to a compose deploy.resources value (плагін не має представлення для отриманого значення; compose: вузол, контейнер: compose: запит nvidia.com/gpu і ліміт за шляхами вимагають різних кількостей; compose резервує для сервісу одну кількість пристроїв, тож запишіть однакову кількість в обох або лише ліміт: кількість ресурсів не можна перетворити на значення deploy.resources у compose)

Якщо шаблон сутності Workload читає значення, яке автор оголосив чутливим, жодне повідомлення не цитує відхилене значення, і обидві кількості так само пропускаються.

Як виправити: якщо значення не є кількістю, запишіть його у формі, описаній у Workload → Кількості ресурсів; голий суфікс, як-от m, — це те, що залишає шаблон, коли інтерпольоване значення порожнє, тож виправляти слід вхідне значення, яке прочитав шаблон. Якщо це кількість, яку compose не може представити, запишіть величину в межах діапазону, вказаного в повідомленні: пам’ять — як ціле число байтів у будь-якій одиниці (1536Mi, а не 1.5001Gi), процесорний час — щонайбільше з дев’ятьма десятковими знаками ядра, а кількість GPU — як ціле число пристроїв (1, а не 0.5 чи 500m). Якщо запит і ліміт GPU розходяться, запишіть однакову кількість в обох або лише ліміт — саме цю кількість Kubernetes планує для тієї самої сутності Workload.

Кількість ресурсу, яку видає провайдер helm, не є кількістю

Провайдер helm дослівно копіює кожну кількість ресурсу в маніфести, які він видає, — значення resources.requests і resources.limits кожного контейнера та init-контейнера, включно з розширеними ресурсами, а також ephemeral.sizeLimit, persistent.size і persistentTemplate.size кожного тому, — і спершу перевіряє кожне з них на відповідність формі кількості, на сутності Workload у тому вигляді, в якому її обчислили шаблони сутності Recipe. Значення поза цією формою зупиняє збірку тут, хоча інакше збірка пройшла б без помилок, а кластер відхилив би його під час встановлення чарту.

Повідомлення, що виводиться. Воно починається з умови, далі називає вузол, шлях до поля в сутності Workload, значення і те, чому воно не є кількістю, та вказує форму, яку має кількість:

a plugin has no representation for a value it was given (плагін не має представлення для переданого йому значення) helm: node "<node>": <path>: "<value>" is not a quantity: <reason>; a quantity is a number such as 2, 0.5 or 1.5, with an optional sign and at most one of an integer exponent (1e3, 5E-2) or a unit suffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei) (helm: вузол: значення не є кількістю; кількість — це число, наприклад 2, 0.5 або 1.5, з необов’язковим знаком і щонайбільше одним із двох: цілим показником степеня (1e3, 5E-2) або суфіксом одиниці (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei))

Як виправити: запишіть значення у формі, описаній у Workload → Кількості ресурсів. Якщо поле задано шаблоном, виправляти слід те значення, яке прочитав шаблон: голий суфікс, як-от m або Mi, — це те, що лишає шаблон, коли інтерпольоване ним значення порожнє, а параметр сутності Release потрапляє в поле точно таким, яким його записано.

Тип сервісу, який провайдер helm не може відрендерити

Провайдер helm рендерить кожен запис services сутності Workload як Kubernetes Service, тип якого — type запису. Запис Loopback вимагає, щоб його порти були досяжні з власної loopback-адреси хоста і більше нізвідки, а в Kubernetes Service немає типу, який це робить: на яких адресах вузлів слухає Service типу NodePort, — це налаштування всього кластера, а не окремого Service. Тому збірка зупиняється на першому записі Loopback у порядку оголошення сервісів, ще до запису будь-якого ресурсу.

Збірка зупиняється, а не рендерить запис як інший тип, бо кожен із типів, які Service має, змінює те, куди сягає порт: Service типу ClusterIP відкидає опубліковану досяжність, якої вимагає запис, а Service типу NodePort публікує порт на кожній адресі вузла, яку дозволяє кластер, — тобто ширше відкриття, якого запис якраз має уникнути.

Повідомлення, що виводиться. Воно починається з умови, далі називає вузол, шлях до сервісу в сутності Workload і тип:

a plugin has no representation for a value it was given (плагін не має представлення для переданого йому значення) helm: node "<node>": services.<service>: type “Loopback” publishes the service’s ports on the host’s loopback address only, and a Kubernetes Service has no type that does; declare ClusterIP to keep the ports inside the cluster, or NodePort or LoadBalancer to publish them outside it (helm: вузол: тип «Loopback» публікує порти сервісу лише на loopback-адресі хоста, а в Kubernetes Service немає типу, який це робить; оголосіть ClusterIP, щоб порти лишалися всередині кластера, або NodePort чи LoadBalancer, щоб опублікувати їх назовні)

Як виправити: для цілі helm оголосіть тип, який визначає, наскільки далеко в кластері має сягати порт, — ClusterIP, щоб лишити його всередині, NodePort або LoadBalancer, щоб опублікувати його. Запис Loopback призначений для цілі compose, яка публікує порт на 127.0.0.1; див. Workload → services.

Версія Kubernetes, для якої провайдер helm не може відрендерити чарт

Провайдер helm рендерить чарт із джерела для версії Kubernetes, яку називає анотація aggrega.ai/kubernetes-version на компоненті або на його межі, і читає значення так, як helm template --kube-version читає свій прапорець. Значення, яке цей прапорець відхилив би, — "one.two", "latest", одне число, як-от "1", число з нулем на початку, як-от "01.20", — не дає версії, яку чарт міг би прочитати як .Capabilities.KubeVersion, тож збірка зупиняється до рендерингу чарту.

Збірка зупиняється, а не рендерить чарт для версії за замовчуванням, бо чарт читає версію, щоб вибрати версію API, поле чи цілий механізм, і чарт, відрендерений для іншої версії, ніж названа вами, видає форму для тієї іншої версії — таку, яку кластер, куди він розгортається, може не підтримувати.

Порожнє значення не відхиляється. Воно вважається незаданим, і чарт рендериться для версії за замовчуванням: тієї, для якої рендерить стандартний helm template того самого випуску helm.

Повідомлення, що виводиться. Воно починається з умови, далі називає вузол і межу, в якій він розміщений, анотацію, значення і те, чому воно не є версією, та вказує форму, яку слід записати:

a plugin has no representation for a value it was given (плагін не має представлення для переданого йому значення) helm: node "<node>" in boundary "<boundary>": annotation aggrega.ai/kubernetes-version: "<value>" is not a Kubernetes version a chart can be rendered for: <reason>; write the version of the cluster the chart deploys to, such as “1.31” or “v1.31.2”, on the component or on its boundary (helm: вузол у межі: анотація aggrega.ai/kubernetes-version: значення не є версією Kubernetes, для якої можна відрендерити чарт; запишіть версію кластера, куди розгортається чарт, наприклад «1.31» або «v1.31.2», на компоненті або на його межі)

Повідомлення називає і вузол, і його межу, бо провайдер читає анотації компонента та його межі разом, причому власне значення компонента має перевагу, тож значення могло бути записане в будь-якому з цих місць.

Як виправити: запишіть версію кластера, куди розгортається чарт, — мажорну й мінорну версію, як-от "1.31", або повну, як-от "v1.31.2", — на компоненті або на його межі, або видаліть анотацію, щоб рендерити для версії за замовчуванням. Див. helm → Версія Kubernetes, для якої рендериться чарт.

Перевірку здоров’я неможливо перетворити на healthcheck compose

Оголошена перевірка здоров’я стає healthcheck у compose, і завадити цьому можуть дві речі.

Перевірка, що перевіряє шлях через HTTP, на контейнері, який не публікує жодного порту. Перевірка будується як запит до порту контейнера, тож без оголошеного порту немає адреси, до якої її можна побудувати.

Перевірка, яка взагалі не оголошує способу перевірки — ні шляху, ні порту для з’єднання, ні команди для запуску. Немає нічого, що можна перетворити на перевірку. Це запобіжник за схемою, а не форма, яку ви, ймовірно, напишете: перевірку перевіряють на наявність одного з трьох ще до того, як вона сюди потрапить.

Повідомлення, що виводяться. Обидва повідомляють ту саму умову — щось, що потрібне провайдеру, він не зміг звести рівно до одного значення, — а власне речення провайдера каже, що саме:

a plugin could not resolve something it requires to exactly one value (плагін не зміг звести потрібне йому рівно до одного значення) compose: node "<node>" container "<container>": probe http: requires at least one container port; container declares none (compose: вузол, контейнер: перевірка http: потрібен щонайменше один порт контейнера; контейнер не оголошує жодного)

a plugin could not resolve something it requires to exactly one value (плагін не зміг звести потрібне йому рівно до одного значення) compose: node "<node>" container "<container>": probe declares no shape (http/tcp/exec) (compose: вузол, контейнер: перевірка не оголошує форми (http/tcp/exec))

Як виправити: оголосіть порт, до якого має виконуватися перевірка, на тому самому контейнері, що й перевірка, — перевірка через HTTP читає перший порт контейнера, тож порт має існувати, щоб перевірку можна було побудувати. Якщо контейнер справді нічого не публікує, перевіряйте його інакше: перевірці, що запускає команду, порт не потрібен. Перевірці без оголошеного способу перевірки задайте один із трьох.

Том configmap не має файлу за собою

Том, що монтує конфігурацію, доставляється власним механізмом compose для цього, на який посилаються за іменем, а запис із вмістом походить із файлу, який видає Recipe. Ця умова — те, що повідомляє посилання без відповідного запису: файлу немає, тож монтування існувало б без нічого за ним, і контейнер запустився б, читаючи порожній шлях.

Перевірка виконується над усім зібраним виводом, а не для кожного компонента окремо, і це зроблено навмисно: посилання та запис із вмістом надходять різними шляхами й можуть походити з різних компонентів однієї групи, тож зібраний вивід — перше місце, де присутні обидва. Перевірка для кожного компонента окремо відхилила б посилання, вміст якого надає інший компонент тієї самої групи.

Повідомляється про кожне нерозв’язане посилання, а не лише про перше, у стабільному порядку, тож одна збірка називає їх усі.

Повідомлення, що видається. Спочатку йде умова, далі кожен сервіс, посилання, яке він зробив, і місце монтування:

a plugin could not resolve something it requires to exactly one value (плагін не зміг розв’язати те, що йому потрібно, до рівно одного значення) 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: сервіс посилається на config, змонтований у шляху; оголосіть кожен як запис configs: верхнього рівня з входу artifacts: сутності Recipe: том configmap потребує файлу, виданого через вхід artifacts: сутності Recipe; нічого не знайдено)

Як виправити: видайте файл із входу artifacts: сутності Recipe під іменем, на яке посилається том, — їх зіставляють саме за цим іменем, тож звичайна причина — розбіжність між тим, що запитує том, і тим, що видає Recipe. Якщо вміст мав надходити звідкись інше, том — неправильний механізм для цього: значення, яке належить до середовища, слід передати туди.

Те, що пропустив запис omits, досі названо у файлі compose

Запис omits: пропускає сервіс, том або config із файлу compose, взятого з джерела, а compose відхиляє файл, що називає те, чого він не оголошує. Тож щойно одиниці записів вилучено, кожне посилання, яке решта файлу досі робить на одну з них, зупиняє рендеринг: сервіс, названий у depends_on, links, volumes_from, extends, у значенні build.additional_contexts або в режимі мережі, IPC, PID чи UTS service:; том, названий джерелом запису volumes:; config, названий записом configs:, — це читається в кожному сервісі, у хуках pre_start кожного сервісу та в кожному job. Повний перелік і значення, які лише схожі на посилання, наведено в compose → Режим із джерелом.

Перевірка читає власний файл сутності Recipe або FeatureRecipe, що оголошує запис, тож вона зупиняє рендеринг навіть тоді, коли інший учасник того самого зібраного файлу оголошує одиницю з іменем пропущеної. Повідомляється про кожне посилання, а не лише про перше, — сервіси в порядку ключів, потім jobs, хуки кожного сервісу після нього, — тож одна збірка називає їх усі.

Повідомлення, що видається. Спочатку йде умова, далі кожен запис, що посилається, одиниця, яку він називає, і поле, у якому є посилання:

a plugin could not resolve something it requires to exactly one value (плагін не зміг розв’язати те, що йому потрібно, до рівно одного значення) 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: те, що пропустив запис omits, досі названо у файлі: сервіс називає одиницю в полі; compose відхиляє файл, що називає сервіс, том або config, яких він не оголошує: пропустіть також те, що їх називає, змініть посилання через valuesMapping або вилучіть запис)

Одиниця, ім’я запису якої побудовано зі значення, оголошеного чутливим, відображається як <redacted>.

Як виправити: визначте, що з двох ви мали на увазі. Якщо сервісу, що посилається, одиниця досі потрібна, залиште її: вилучіть запис. Якщо ні, змініть посилання через valuesMapping: сутності Recipe — список там замінює список базового файлу, тож depends_on: [] очищає його, — або пропустіть сервіс, що посилається, окремим записом.

Те, що пропустив запис omits, досі названо в шаблоні CloudFormation

Запис omits: пропускає ресурс із шаблону CloudFormation, взятого з джерела, а CloudFormation відхиляє шаблон, що називає ресурс, якого він не оголошує. Тож щойно ресурси записів вилучено, кожне посилання, яке решта шаблонів досі робить на один із них, зупиняє рендеринг: Ref, Fn::GetAtt у формі списку або рядка з крапками, DependsOn ресурсу чи змінна Fn::Sub, — це читається будь-де в тілі кожного ресурсу та в кожному output. Повний перелік і значення, які лише схожі на посилання, наведено в cloudformation → Пропуск ресурсів із шаблону з джерела.

Перевірка читає власні шаблони сутності Recipe або FeatureRecipe, що оголошує запис, разом: посилання на логічний ID, який досі оголошує інший із цих шаблонів, не зупиняється, тоді як посилання на пропущений ресурс зупиняє рендеринг навіть тоді, коли інший компонент оголошує ресурс із цим логічним ID. Повідомляється про кожне посилання, а не лише про перше, — шаблон за шаблоном у порядку, у якому їх містить джерело, ресурси кожного шаблону, а потім його outputs у порядку ключів, — тож одна збірка називає їх усі.

Повідомлення, що видається. Спочатку йде умова, далі кожне посилання: шаблон, у якому воно є, ресурс, який воно називає, спосіб, у який воно його називає, і місце, де воно розташоване, як шлях від кореня шаблону:

a plugin could not resolve something it requires to exactly one value (плагін не зміг розв’язати те, що йому потрібно, до рівно одного значення) 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: те, що пропустив запис omits, досі названо в шаблонах джерела: шаблон називає ресурс (тип) у шляху; CloudFormation відхиляє шаблон, що називає ресурс, якого він не оголошує: пропустіть також те, що його називає, або вилучіть запис)

Якщо поля запису побудовано зі значення, оголошеного чутливим, логічний ID і тип його ресурсу відображаються як <redacted>, так само як і будь-який крок шляху, що містить цей логічний ID.

Як виправити: визначте, що з двох ви мали на увазі. Якщо ресурсу, що посилається, пропущений ресурс досі потрібен, залиште його: вилучіть запис. Якщо ні, пропустіть також ресурс, що посилається, окремим записом — значення, прив’язане до параметра, замінює лише посилання на цей параметр, тож посилання на ресурс ним змінити не можна. Output, що називає ресурс, пропустити не можна, тож ресурс, який називає output, залишається.

Ключ valuesMapping не називає жодного параметра шаблону CloudFormation з джерела

Шаблон CloudFormation з джерела приймає значення через оголошені ним Parameters, а valuesMapping сутності Recipe або FeatureRecipe, що його бере з джерела, записує по одному ключу на кожен параметр, який заповнює. Ключ, що не називає жодного параметра, оголошеного будь-яким шаблоном джерела, не має куди потрапити, тож рендеринг зупиняється, а не відкидає його, — це та помилка, яку сам CloudFormation повідомив би для невідомого параметра, але повідомлена тоді, коли її ще можете виправити ви. Параметри заповнює лише valuesMapping: значення, які ніщо не відобразило, так ніколи не читаються, тож власні значення компонента або приєднання, записані для інших його входів, ніколи з цим не стикаються.

Повідомлення, що видається. Спочатку йде умова, далі кожен ключ, що нічого не назвав, і те, що оголошує кожен шаблон джерела:

a plugin could not resolve something it requires to exactly one value (плагін не зміг розв’язати те, що йому потрібно, до рівно одного значення) 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 сутності Recipe або FeatureRecipe записує ключ, і жоден шаблон джерела не оголошує параметра з таким іменем: шаблон оголошує …; шаблон з джерела приймає значення лише через оголошені ним параметри, тож перейменуйте ключ на параметр, для якого він призначений, або вилучіть його з valuesMapping)

Як виправити: порівняйте ключ із параметрами, які перелічує повідомлення, — звичайна причина — помилка в написанні ключа, — і перейменуйте його або вилучіть із valuesMapping. Див. cloudformation → Значення для параметрів шаблону з джерела.

Інший компонент посилається на параметр CloudFormation, який заповнило прив’язування шаблону з джерела

Заповнення параметра шаблону з джерела через valuesMapping сутності Recipe або сутності FeatureRecipe приєднаної сутності Feature, що бере його з джерела, замінює кожне посилання на цей параметр у кожному шаблоні цього джерела та вилучає його оголошення. Вміст з іншого місця того самого зібраного стека — фрагмент чи шаблон з джерела іншого компонента або фрагмент компонента, до якого приєднано сутність Feature, — що досі називає параметр через Ref, змінну Fn::Sub або Fn::ValueOf правила, тоді називає те, чого стек уже не оголошує, і CloudFormation відхиляє це під час розгортання стека, тож збирання зупиняється. Ім’я, яке якийсь компонент стека досі оголошує як власний параметр або як логічний ID ресурсу, є посиланням, яке стек розв’язує, і не зупиняється.

Виведене повідомлення. Спершу йде умова, потім кожне посилання: компонент і шаблон, у яких воно є, параметр і компонент, чия valuesMapping сутності Recipe або приєднаної сутності FeatureRecipe його заповнила, — сутність Feature, приєднану до компонента, названо за цим компонентом, а приєднану до межі — за ідентичністю, яку її ресурси несуть як aggrega.ai/component-id, складеною зі шляху межі та імені приєднання, наприклад bfr--stack--aux:

a plugin could not resolve something it requires to exactly one value cloudformation-provider: a parameter a sourced template’s binding filled is still referenced from elsewhere in the assembled stack: component "<component>"’s template "<template>" references parameter "<parameter>", which the valuesMapping of a Recipe or FeatureRecipe rendering for component "<component>" binds; …; binding a parameter removes its declaration from the source that declares it, and no template in the stack declares it any more, so the reference names nothing CloudFormation can resolve: reference what the binding component publishes instead, declare the parameter in the template that references it, or remove the key from the valuesMapping (плагін не зміг звести те, чого він потребує, до рівно одного значення; cloudformation-provider: на параметр, який заповнило прив’язування шаблону з джерела, досі посилаються з іншого місця зібраного стека: шаблон компонента посилається на параметр, який прив’язує valuesMapping сутності Recipe або FeatureRecipe, що рендерить для компонента; …; прив’язування параметра вилучає його оголошення з джерела, яке його оголошує, і жоден шаблон у стеку його більше не оголошує, тож посилання називає те, чого CloudFormation не може розв’язати: натомість посилайтеся на те, що публікує компонент із прив’язуванням, оголосіть параметр у шаблоні, що на нього посилається, або вилучіть ключ із valuesMapping)

Як виправити: якщо компоненту, що посилається, потрібне значення, нехай компонент, який його заповнює, опублікує його через provides, і посилайтеся на це; або оголосіть параметр у шаблоні, що посилається, щоб він отримував власне значення; або вилучіть ключ із valuesMapping, щоб параметр залишився оголошеним і кожен компонент читав значення, передане під час розгортання стека. Див. cloudformation → Значення для параметрів шаблону з джерела.

Значення, прив’язане до параметра CloudFormation, не може набути типу параметра

Літерал, прив’язаний до параметра, перетворюється так, як CloudFormation перетворює те саме значення, передане для Type цього параметра під час розгортання стека. Якщо такого перетворення немає, рендеринг зупиняється: значення, що не є числом, прив’язане до Number або List<Number>; список чи відображення, прив’язане до параметра, що приймає одне значення; і будь-який літерал, прив’язаний до параметра AWS::SSM::Parameter::Value<…>, значення якого CloudFormation читає з Parameter Store, а не з шаблону. Список, прив’язаний до параметра, який шаблон називає як змінну Fn::Sub, також зупиняє рендеринг, бо змінна підставляє один рядок.

Виведене повідомлення. Спершу йде умова, потім параметр, його шаблон і тип, а також причина, з якої значення не підходить; жодне значення не цитується:

a plugin has no representation for a value it was given cloudformation-provider: parameter "<parameter>" of template "<template>" is of type <type>, and <why the value does not fit> (плагін не має подання для переданого йому значення; cloudformation-provider: параметр шаблону має тип, і значення не підходить)

Як виправити: прив’яжіть значення типу параметра — або, для типу Parameter Store, динамічне посилання {{resolve:ssm:…}} чи внутрішню функцію — або залиште параметр неприв’язаним для значення, переданого під час розгортання стека.

Значення, прив’язане до параметра CloudFormation, відхиляють його обмеження

Літерал, прив’язаний до параметра, перевіряється на відповідність обмеженням, які шаблон для нього оголошує, — AllowedValues, AllowedPattern, MinLength, MaxLength, MinValue і MaxValue; це перевірка, яку CloudFormation виконує для значення, переданого під час розгортання стека, перенесена на час збирання, щоб заповнення параметра не вилучало жодної перевірки, оголошеної шаблоном. Внутрішню функцію та динамічне посилання залишено на перевірку CloudFormation, оскільки їхнє значення не існує до розгортання стека.

Виведене повідомлення. Спершу йде умова, потім параметр, його шаблон і обмеження; жодне значення не цитується:

a plugin has no representation for a value it was given cloudformation-provider: the value bound to parameter "<parameter>" of template "<template>" does not satisfy its <constraint>, which CloudFormation would refuse when the stack deploys; bind a value the parameter admits (плагін не має подання для переданого йому значення; cloudformation-provider: значення, прив’язане до параметра шаблону, не задовольняє його обмеження, і CloudFormation відхилив би його під час розгортання стека; прив’яжіть значення, яке допускає параметр)

Як виправити: прив’яжіть значення, яке допускає обмеження; власне оголошення параметра в шаблоні перелічує, що воно дозволяє.

Секрет, прив’язаний до параметра CloudFormation, буде записано в шаблон

Значення, прив’язане до параметра, записується в шаблон, де його може прочитати будь-хто, хто може прочитати шаблон стека. Рендеринг зупиняється на літералі, прив’язаному до параметра, який шаблон оголошує NoEcho, а якщо valuesMapping сутності Recipe або FeatureRecipe читає значення, яке автор оголосив чутливим, — на кожному літералі, який прив’язує це відображення, оскільки жоден його вихід не можна простежити до значення, з якого він походить. Динамічне посилання та внутрішню функцію записано як є — разом із текстом усередині внутрішньої функції, — тож чутливе значення, яке відображення вставляє в рядок Fn::Sub, потрапляє в шаблон як цей текст, і лише динамічне посилання не допускає до нього сам секрет.

Виведене повідомлення. Спершу йде умова, потім параметри та те, що слід прив’язати натомість; жодне значення не цитується. Одне з:

a plugin has no representation for a value it was given cloudformation-provider: parameter "<parameter>" of template "<template>" is declared NoEcho, and the value bound to it would be written into the template as it stands; bind a dynamic reference ({{resolve:secretsmanager:…}} or {{resolve:ssm-secure:…}}) or an intrinsic function instead, or leave the parameter unbound for a deploy-time value (плагін не має подання для переданого йому значення; cloudformation-provider: параметр шаблону оголошено NoEcho, і прив’язане до нього значення було б записано в шаблон як є; натомість прив’яжіть динамічне посилання ({{resolve:secretsmanager:…}} або {{resolve:ssm-secure:…}}) чи внутрішню функцію або залиште параметр неприв’язаним для значення під час розгортання)

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 сутності Recipe або FeatureRecipe читає значення, оголошене чутливим, тож створений ним літерал відхиляється, а прив’язування параметрів … записало б літерал у шаблон як є; …)

Як виправити: збережіть секрет у Secrets Manager або як захищений рядок Parameter Store і прив’яжіть до нього динамічне посилання — {{resolve:secretsmanager:<secret>}} або {{resolve:ssm-secure:<name>}} — замість вставляти його в текст внутрішньої функції, або залиште параметр неприв’язаним для значення, переданого під час розгортання стека. Див. cloudformation → Значення для параметрів шаблону з джерела.

Динамічне посилання прив’язано там, де CloudFormation його не розв’язує

CloudFormation розв’язує динамічне посилання у властивостях ресурсу, але не в даних користувача EC2 і не в метаданих AWS::CloudFormation::Init, а Outputs шаблону показує кожному, хто читає стек. Тому динамічне посилання, прив’язане до параметра, на який будь-який шаблон джерела посилається у властивості UserData, у цих метаданих або у своїх Outputs, зупиняє рендеринг, а не потрапляє туди, де його або неможливо розгорнути, або воно відкрите.

Повідомлення, що виводиться. Спершу умова, потім параметр, шаблон і місце, де цей шаблон на нього посилається; жодне значення не цитується:

a plugin has no representation for a value it was given (плагін не має представлення для переданого йому значення) 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: значення, прив’язане до параметра, є динамічним посиланням, а шаблон посилається на параметр там, де CloudFormation не розв’язує динамічне посилання або показує його кожному, хто читає стек; натомість прив’яжіть вбудовану функцію або залиште параметр неприв’язаним для значення під час розгортання)

Як виправити: залиште параметр неприв’язаним і передайте його значення під час розгортання стека або прив’яжіть вбудовану функцію, яка дає те, що потрібно шаблону в цьому місці.

Правило читає прив’язаний параметр CloudFormation за іменем

Fn::ValueOf у Rules шаблону називає параметр за його логічним ID, а не через Ref, і читає значення, передане для нього під час розгортання стека. Прив’язка параметра видаляє його оголошення з кожного шаблону джерела, через що правило — у будь-якому з цих шаблонів — не називало б нічого, тож рендеринг зупиняється.

Повідомлення, що виводиться. Спершу умова, потім правило, його шаблон і параметр:

a plugin has no expression for a construct this build declares (плагін не має виразу для конструкції, яку оголошує ця збірка) 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: правило шаблону читає параметр через Fn::ValueOf, що називає оголошений параметр за логічним ID, а прив’язка параметра видаляє його оголошення з джерела; залиште параметр неприв’язаним, щоб правило могло прочитати його під час розгортання)

Як виправити: видаліть ключ параметра з valuesMapping, щоб параметр лишався оголошеним, а правило читало значення, передане під час розгортання стека.

Зібраний стек CloudFormation не може містити трансформацію

Transform зібраного стека будується з трансформацій усіх компонентів, а трансформація обробляє весь шаблон, тому трансформація, дія якої не обмежена вмістом, написаним для неї, відхиляється, а не отримує змогу змінити розгортання вмісту іншого компонента: AWS::CodeDeployBlueGreen і AWS::Include — завжди, макрос, визначений у вашому обліковому записі, і AWS::ServiceCatalog — поруч із будь-яким іншим компонентом, AWS::LanguageExtensions — поруч із serverless-вмістом іншого компонента, а AWS::Serverless-2016-10-31 — там, де його Globals досягли б serverless-ресурсів іншого компонента або одне з його джерел подій називає ресурс, оголошений іншим компонентом. Повна таблиця — у cloudformation → Розділи верхнього рівня в зібраному стеку.

Повідомлення, що виводиться. Спершу умова, потім кожен компонент стека, трансформація і компоненти, що її оголошують, і причина, чому її не можна містити:

a plugin has no expression for a construct this build declares (плагін не має виразу для конструкції, яку оголошує ця збірка) cloudformation-provider: the assembled stack of component "<component>", … cannot carry the transform "<transform>", declared by component "<component>": <why> (cloudformation-provider: зібраний стек компонента … не може містити трансформацію, оголошену компонентом)

Як виправити: розмістіть компонент, що оголошує трансформацію, в окремій межі, щоб його стек не містив нічого, що трансформація могла б змінити; або, якщо повідомлення називає вміст, оголошений іншим компонентом, перенесіть цей вміст у компонент, що оголошує трансформацію.

Два компоненти впорядковують одну пару трансформацій протилежно

Зібраний стек виконує свої трансформації в одному порядку, побудованому з власного порядку кожного компонента та з порядку, задокументованого CloudFormation. Там, де два порядки не можуть виконуватися водночас — два компоненти перелічують одну пару трансформацій у протилежному порядку або компонент перелічує AWS::Serverless-2016-10-31 перед AWS::LanguageExtensions, тоді як CloudFormation документує навпаки, — немає одного порядку, який можна записати, тож рендеринг зупиняється.

Повідомлення, що виводиться. Спершу умова, потім пара і хто впорядкував її кожним способом:

a plugin could not resolve something it requires to exactly one value (плагін не зміг звести те, що йому потрібно, до рівно одного значення) 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: трансформації впорядковано в обидва боки, а Transform зібраного стека виконує їх в одному порядку; оголосіть їх в одному порядку)

Як виправити: оголосіть пару в одному порядку в кожному компоненті, що перелічує обидві, дотримуючись власного порядку CloudFormation там, де він його документує.

Два записи дають одне ім’я виводу стека

Ім’я виводу стека допускає лише літери й цифри, тому воно будується з написаного вами кодуванням символів, яких цей алфавіт не допускає, а не їх відкиданням. Тож два записи, які ви написали по-різному, лишаються різними, і ця зупинка повідомляє про випадок, коли два з них усе ж дають одне ім’я. Рендеринг зупиняється, а не виводить один вивід там, де було написано два записи, що непомітно відкинуло б один із них.

Повідомляється кожне ім’я, у якому зійшлися два чи більше записів, і називається кожен запис за кожним ім’ям, у стабільному порядку — тож одна збірка показує вам усю колізію, а не один її бік.

Повідомлення, що виводиться: спершу умова, далі власні подробиці провайдера:

two things a plugin produced occupy one name in its output (дві речі, створені плагіном, займають одне ім’я в його виводі) 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: два записи, написані автором, дають одне ім’я Output стека; ім’я Output будується кодуванням компонента й запису в літери та цифри, які допускає логічний id, а не відкиданням недопустимого, тож два записи, написані по-різному, лишаються різними — перейменування будь-якого з них усуває помилку збірки)

Як виправити: перейменуйте один із записів або один із компонентів, щоб вони більше не давали одне ім’я, — повідомлення називає обидва боки. Ім’я зберігає написані вами розділові знаки й регістр літер, закодовані, а не відкинуті, тож різниця в будь-чому з них зберігається в ньому, і два по-різному написані записи отримують різні імена.

Фрагмент CloudFormation записує один ключ двічі

Мапа містить одне значення на ключ, тож фрагмент, що записує той самий ключ двічі, зберіг би тіло, яке йшло останнім, і відкинув би інше. Якщо мапа — це блок із ресурсами чи виводами, відкинуте тіло є записаним ресурсом або виводом, якого не було б у результаті. Натомість рендеринг зупиняється.

Повідомляються обидва місця, де записано ключ, бо двічі записаний ключ зазвичай є двома правками, що мали бути двома різними ключами, — і автору потрібні обидва, щоб зрозуміти, який змінити.

Повідомлення, що виводиться: спершу умова, далі власні подробиці провайдера:

two things a plugin produced occupy one name in its output (дві речі, створені плагіном, займають одне ім’я в його виводі) 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: один ключ мапи записано більше одного разу: ключ записано в одному рядку і знову в іншому; мапа містить одне значення на ключ, тож одне з двох тіл було б відкинуто — видаліть одне або перейменуйте одне, щоб кожен ключ записувався один раз)

Як виправити: відкрийте фрагмент у двох рядках, які називає повідомлення. Якщо два тіла мали бути одним, видаліть те, що тепер зайве; якщо їх мало бути два, перейменуйте одне, щоб кожне мало власний ключ. Фрагмент є шаблоном, тож там, де ключ складається, а не записується буквально, перевіряйте відрендерений текст, а не лише джерело.

A cross-boundary reference has no consuming stack to be written into (Міжмежове посилання не має стека-споживача, у який його можна записати)

Коли залежність з’єднує два окремо зібрані виводи, сторона-споживач рендериться із заповнювачем, а посилання записується, щойно існують обидві сторони. Ця умова виникає, коли зібраний вивід сторони-споживача не містить жодного шаблону стека: немає документа, у який можна записати посилання, тож заповнювач неможливо замінити.

Повідомлення, що виводиться. Умова називає вид збою, а власне речення провайдера вказує, який саме вхід:

a plugin could not resolve something it requires to exactly one value (плагін не зміг звести те, чого він потребує, рівно до одного значення) cloudformation-provider: cross-boundary link resolve received no consumer stack template (розв’язання міжмежового зв’язку не отримало шаблону стека-споживача)

Як виправити: ніщо з написаного вами всередині компонента-споживача цього не спричиняє — це форма того, що зібрала його межа. Перевірте, чи сторона-споживач взагалі рендериться провайдером CloudFormation: з’єднання, що входить у межу, яка збирає щось інше, не має стека, куди могло б потрапити посилання, і таке з’єднання має пролягати між двома межами, які збирає той самий провайдер. Якщо обидві сторони мають бути CloudFormation, то межа-споживач не створила шаблону стека, і це питання до того, хто написав сутності Recipes, що до неї долучаються.

A cross-boundary reference was spliced into a longer string (Міжмежове посилання вставлено в довший рядок)

Перехресне посилання CloudFormation — це об’єкт, а не текст, тож воно може лише замінити значення повністю. Цю умову повідомляє заповнювач, знайдений усередині більшого рядка, — значення, складене навколо нього, а не передане як усе, що було впроваджено. Немає на що замінити об’єкт, тож рендеринг зупиняється, а не виводить посилання у формі, яку ціль не може прочитати.

Повідомлення, що виводиться. Спочатку умова, потім значення та з’єднання, яким воно надійшло:

a plugin has no representation for a value it was given (плагін не має представлення для переданого йому значення) 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>" (значення міжмежового зв’язку інтерпольовано в більший рядок; міжстекове посилання може нести лише впровадження цілого скаляра: вихідний ключ на сокеті)

Як виправити: передавайте значення цілим, а не складайте щось навколо нього. Якщо стороні-споживачу потрібне значення всередині довшого рядка — рядка підключення, URL — побудуйте цю композицію з посилання засобами словника самої цілі, а не в шаблоні сутності Recipe до того, як посилання існує. Вставка відбувається в зіставленні, яке впроваджує значення, тож саме цей рядок і слід змінити.

Two rendered resources land at one output file (Два відрендерені ресурси потрапляють в один вихідний файл)

Кожен відрендерений ресурс записується у файл, ім’я якого походить від того, чим є ресурс і як він називається. Два ресурси, у яких це збігається, мають однакове ім’я файлу, тож один зайняв би місце іншого, і рендеринг зупиняється, а не виводить один файл там, де відрендерено два ресурси.

Два ресурси, що рендеряться однаково, не є колізією. Якщо вміст збігається побайтово, збереження одного нічого не втрачає, і рендеринг триває — тож про шаблон, включений двічі з однаковим результатом, не повідомляється.

Повідомлення, що виводиться. Спочатку умова, потім обидва шаблони, що їх створили, і файл, у якому вони зустрілися:

two things a plugin produced occupy one name in its output (дві речі, створені плагіном, займають одне ім’я в його виводі) 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 (вузол: відрендерені ресурси і обидва виводять однаковий вихідний файл із різним вмістом: два відрендерені ресурси виводять однакове ім’я вихідного файлу з різним вмістом)

Як виправити: надайте двом ресурсам різні ідентичності — зазвичай відрізняється ім’я, а ім’я файлу випливає з нього. Повідомлення називає обидва шаблони, тож відкрийте їх і перевірте, що створює кожен: два шаблони, що рендерять той самий ресурс під одним ім’ям, часто означають, що один із них — старіша копія. Якщо потрібні обидва, це два ресурси, і кожному потрібне власне ім’я.

A synthesized StatefulSet has no single service to govern it (Синтезований StatefulSet не має єдиного сервісу, що ним керує)

Workload, що оголошує сховище для кожного екземпляра, рендериться як StatefulSet, а StatefulSet називає один сервіс, що ним керує, — той, що дає кожному екземпляру стабільну адресу. Це сервіс, оголошений без власної кластерної адреси. Рендеринг зупиняють дві форми: не оголошено жодного, тож нема чого назвати; і оголошено більше одного, тож на питання, який із них керує, немає відповіді. Кожна з них дала б StatefulSet, який ціль відхиляє, тож рендеринг зупиняється замість того, щоб його вивести.

Повідомлення, що виводяться. Обидва повідомляють ту саму умову — те, чого потребує провайдер, але не зміг звести рівно до одного значення, — а власне речення провайдера вказує, яку з двох форм виявлено. Кожне виводиться під рамкою, що називає вузол:

a plugin could not resolve something it requires to exactly one value (плагін не зміг звести те, чого він потребує, рівно до одного значення) synthesized StatefulSet requires a headless governing Service (declare a service with type: Headless); none found: synthesized StatefulSet has no headless governing Service (синтезований StatefulSet потребує headless-сервісу, що ним керує (оголосіть сервіс із type: Headless); жодного не знайдено: синтезований StatefulSet не має headless-сервісу, що ним керує)

a plugin could not resolve something it requires to exactly one value (плагін не зміг звести те, чого він потребує, рівно до одного значення) 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 оголошує більше одного headless-сервісу; керівний сервіс неоднозначний (оголосіть рівно один сервіс type: Headless): синтезований StatefulSet має більше одного headless-сервісу)

Як виправити: оголосіть у workload рівно один сервіс типу headless. Якщо не оголошено жодного, додайте його — workload зі сховищем для кожного екземпляра потребує такого сервісу, і саме він дає кожному екземпляру адресу, що за ним закріплена. Якщо оголошено більше одного, залиште той, що має керувати, а іншим дайте звичайний тип або видаліть їх; другий headless-сервіс зазвичай не мав бути headless.

A plugin reported a failure it did not classify (Плагін повідомив про збій, який не класифікував)

Плагін, що зупиняє збірку, повідомляє дві речі: власне речення про те, що сталося, і вид збою, який це речення називає. Види — це невеликий набір, який оголошує компілятор, — конструкція без вираження, вхід, який не вдалося звести до одного значення, дві створені речі, що претендують на одне ім’я, значення без представлення, — а ця умова є тією, яку плагін обирає, коли його збій не підходить жодному з них.

Це резервний варіант, а не пункт призначення. Плагін, що вдається до нього там, де підходить один з інших видів, повідомляє вам менше, ніж знає, а формулювання прямо каже, що плагін відмовився класифікувати, а не що просто щось пішло не так, — тож надмірне використання резервного варіанта помітне, а не невідрізненне від коректного звіту.

Повідомлення, що виводиться. Спочатку умова, а за нею власне речення плагіна:

a plugin reported a failure that none of the declared kinds names (плагін повідомив про збій, який не називає жоден з оголошених видів) <the plugin's own sentence>

Як виправити: прочитайте власне речення плагіна — саме в ньому все, що стосується вашої збірки. Сама умова повідомляє лише, що плагін не мав для цього виду. Якщо плагін ваш, оберіть вид, яким збій насправді є; якщо ні, саме це речення слід процитувати тому, хто його публікує.

A plugin named a condition the socket does not declare (Плагін назвав умову, яку сокет не оголошує)

Плагін повідомляє про умову, яку оголошує цей компілятор, а не вигадує власний номер, тож ідентифікатор, що доходить до вас, завжди такий, на який відповідає aggrega explain. Ця зупинка — те, що спричиняє повідомлення, яке називає щось інше: номер, під яким нічого не зареєстровано, номер, який вилучено, короткий код, написаний інакше, ніж реєстрація, на яку він вказує, або пара ідентифікаторів, що називають дві різні умови.

Збірка зупиняється, а не тихо відкидає повідомлення. Якби ідентифікатори було відкинуто й залишено загальну умову збою плагіна, збірка виглядала б точнісінько як збірка від плагіна, що не назвав жодної умови, тож той, кому треба це виправити, ніколи не дізнався б, що є що виправляти. А якби натомість було повідомлено запропонований номер, ви отримали б ідентифікатор, що ні на що не вказує.

Ваша збірка все одно отримує те, що її зупинило. Зупинка цитує хибний номер, пояснює, чому він не вказує на жодну умову, називає загальні умови, до яких плагін вдається, коли не має кращого ідентифікатора, і передає власне речення плагіна без змін.

Повідомлення, що виводиться:

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: гостьовий плагін назвав умову, яку сокет не оголошує: гість назвав …, і …; плагін називає умову, яку оголошує цей компілятор, і вдається до однієї з …, коли не має кращої: …)

Як виправити: ніщо у ваших файлах сутностей цього не спричиняє — хибне саме повідомлення плагіна, а збій, про який він повідомляв, справжній. Дійте відповідно до власного речення плагіна, яке є останньою частиною повідомлення. Якщо плагін ваш, повідомляйте про умову, яку оголошує цей компілятор, — одну із загальних, перелічених у повідомленні, якщо збій не підходить до жодної з конкретніших умов; якщо плагін не ваш, процитуйте хибний номер тому, хто його публікує.

A source artifact is cached without a workspace root to anchor it (Артефакт джерела кешується без кореня робочого простору, до якого його прив’язати)

Отриманий артефакт джерела зберігається в слоті всередині кешу артефактів робочого простору, а шлях до цього слота будується від кореня робочого простору. Ця умова повідомляє, що корінь надійшов порожнім, через що шлях слота став би відносним — розв’язувався б відносно того каталогу, у якому процес випадково перебуває під час запису байтів, і кеш опинився б там, де ніхто його не обирав.

Це відхиляється, а не розв’язується, бо слот, записаний не туди, гірший, ніж відсутність слота: подальші читання шукають у правильному місці, нічого не знаходять і отримують знову, тож ви побачили б кеш, який ніколи нічого не містить, і більше нічого, що вказувало б на причину.

Повідомлення, що виводиться. Його відкриває власне речення умови, а за ним іде те, що ідентифікує артефакт:

cacheslot: empty workspaceRoot (kind=<kind> url=<url> chart=<chart> version=<version>) (cacheslot: порожній workspaceRoot)

Як виправити: ніщо у ваших файлах сутностей цього не спричиняє, і жодна зміна в них цього не усуне — корінь робочого простору надає те, що керує збіркою, а не каталог. Запускайте збірку зсередини робочого простору, щоб корінь було виявлено, а не передано порожнім. Якщо ви керуєте компілятором із власного програмного забезпечення, передавайте корінь робочого простору явно; виклик, який справді хоче кеш відносно поточного каталогу, передає одну крапку, що приймається й свідомо це позначає.

A value would place a cached file outside the cache (Значення розмістило б кешований файл поза кешем)

Кешована сутність і кешований артефакт джерела живуть кожен у слоті, який для нього називає кеш, і цей слот складається зі значень: посилання на сутність і версії, до якої воно розв’язалося, або типу джерела, url, chart, module_subdir, версії та дайджесту. Кожне значення називає одну позицію в структурі. Ця умова повідомляє про значення, яке перемістило б записуване для нього кудись, окрім названої позиції, — поруч з іншим слотом або взагалі за межі кешу, — і відхиляє його до того, як там щось буде записано чи прочитано.

Більшість цих значень надходить звідти, що кеш не контролює: тіло, яке віддав реєстр, запис, прочитаний з диска, координата, яку написав автор Recipe чи FeatureRecipe. Версія, що є шляхом, а не версією, шлях url чи module_subdir, що піднімається вище свого місця, і посилання, що розв’язується до каталогу-крапки, тут відхиляються. Значення, що називає один каталог, — і шлях url чи module_subdir, що залишається на своєму місці або нижче, — не зачіпається.

module_subdir, що піднімається, відхиляється ще до будь-якого завантаження. Для джерела git-repository те саме значення також називає каталог репозиторію, який архівує pull, а значення, що піднімається вище репозиторію, змусило б pull читати файли поруч із його checkout. Тому pull перевіряє module_subdir до завантаження репозиторію і відхиляє значення, що піднімається, з цією умовою, цитуючи його під його ключем: нічого не завантажується й нічого поруч із checkout не читається. Зворотна скісна риска в ньому читається як роздільник, як у шляху Windows, тож ..\shared відхиляється на кожній машині, а не читається поруч із checkout на одній із них; роздільник на початку чи в кінці значення відкидається, тож /charts/app називає charts/app.

Повідомлення, що виводиться. Його відкриває власне речення умови, потім іде значення в тому вигляді, як його написано, під ключем, під яким його написано, і спосіб виправлення:

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 (значення, з якого будується розташування в кеші, розмістило б кешовані файли поза місцем, яке воно називає в кеші. Версія, ім’я, тип чи хост називають один каталог кешу, тож не містять роздільників і не є крапкою чи двома крапками; шлях URL чи підкаталог модуля можуть називати каталоги під своїм місцем, але не можуть підніматися вище. Виправте значення там, де його написано, або, якщо його віддав реєстр, попросіть його публікатора опублікувати версію з коректним значенням)

Як виправити: якщо значення написали ви — source.version, url чи module_subdir сутності Recipe чи FeatureRecipe, — виправте його так, щоб воно називало один каталог або шлях, що залишається в межах свого місця; повідомлення цитує значення й ключ, з якого його прочитано. Якщо його віддав реєстр, опублікована сутність містить хибну версію чи координату, і жодна ваша зміна цього не виправить: повідомлення називає, що було завантажено, а виправлення — за тим, хто це публікує.

Кілька операцій записують або видаляють власні файли в місцях, які вони визначають самі, а не в місцях, які назвали ви: вихідний каталог збірки й кожен файл, який вона туди записує, а також каталог .trace, який замінює збірка з трасуванням; lock-файл сутності Release і запис довіри до плагінів поруч із ним, які записує pull; entity.lock поруч із сутністю, який записує aggrega pin, а також pull, що закріплює джерела, поруч із кожною сутністю, яку він закріплює; .aggrega-config.yaml робочого простору, коли команда записує конфігурацію робочого простору; кеш артефактів і кожне його піддерево, які заповнює pull і спорожнюють aggrega cache clear та aggrega cache prune; пакети підписів, які pull зберігає в цьому кеші для кожного артефакту, підпис якого він перевірив; чернетки, які записує aggrega import; сутності Plugin, які aggrega plugin gen-catalog записує у своєму вихідному каталозі; а також маркер .aggrega/active-release, який записує мовний сервер редактора, коли фіксується типова сутність Release, і каталог .aggrega, що його містить. Те саме стосується будь-якого інтерфейсу, з якого запущено операцію, — командного рядка, мовного сервера редактора чи інструментів асистента. Межа робочого простору описує правило, яке тут застосовується, і шляхи, що навмисно виходять за межі робочого простору.

Кожне з цих місць має каталог, у якому воно має залишатися, і який саме — залежить від каталогу, у якому операція його складає:

  • Робочий простір — для всього, що складається в ньому. Це звичайний випадок, і він стосується також названого вами каталогу, що лежить у робочому просторі. dist і .trace збірки завжди складаються тут, під коренем робочого простору, з якої б теки не запускалася збірка, як і чернетки імпорту, що не називає вихідного каталогу.
  • Названий вами каталог поза робочим простором — для всього, що складається в ньому: вихідний каталог, який ви передаєте aggrega plugin gen-catalog чи aggrega import; каталог сутності Release, яку називаєте ви або конфігурація робочого простору, що лежить поза робочим простором, — для lock-файлу й запису довіри поруч із нею; а також каталог сутності, яку ви називаєте aggrega pin, або каталог каталогу, який ви називаєте через --catalog чи який конфігурація перелічує в catalog_dirs, — для entity.lock поруч із кожною сутністю там. Сам каталог використовується так, як ви його назвали, — якщо це посилання, запис іде через нього туди, куди воно вказує, — а те, що записується в ньому, залишається в його межах.
  • Сам каталог кешу артефактів — для всього, що записується в кеш під ним, і всього, що там видаляють aggrega cache clear та aggrega cache prune, — як типовий .aggrega/cache, так і artifact_cache_dir, який конфігурація записує з виходом за корінь робочого простору (../shared-cache). Власний каталог кешу чи файл у ньому, що є посиланням за межі каталогу кешу, відхиляється, навіть якщо воно веде в інше місце робочого простору, тож ніщо записане в кеш і ніщо видалене очищенням чи обрізанням не потрапляє на файл поза ним. Спершу оцінюється, де лежить сам каталог кешу: записаний усередині кореня робочого простору виконується, куди б не вів у межах робочого простору, і відхиляється, будучи обмеженим робочим простором, якщо веде за його межі; записаний з виходом за корінь робочого простору використовується так, як ви його назвали, із записом через нього туди, куди він вказує, якщо це посилання.

Кожне з цих місць перевіряється до того, як там щось буде записано чи видалено. Найглибша наявна частина шляху, з переходом за кожним символьним посиланням на шляху, має бути каталогом, у якому вона має залишатися, або лежати під ним. Посилання будь-де на шляху, що веде за межі цього каталогу, — dist, пов’язаний із каталогом деінде, lock-файл, пов’язаний із файлом в іншому проєкті, .aggrega/cache, пов’язаний із каталогом, спільним з іншою роботою, каталог у вихідному каталозі gen-catalog, пов’язаний з іншим місцем, — призвело б до запису чи видалення поза ним, тому операція натомість зупиняється, а цей шлях залишається точно таким, яким був. Найважливіше це для збірки: очищення й перезапис вихідного каталогу, що є посиланням, інакше видалили б і перезаписали каталог деінде на машині.

Посилання, що веде в нікуди, розглядається як те, чим воно є, — як щось ненаявне, — тож перевіряється каталог, що його містить. Якщо таке посилання стоїть у самому кінці шляху, який операція збирається створити, файл було б створено там, куди вказує посилання, тож місце, на яке воно вказує, теж перевіряється. Посилання, що вказує кудись усередині каталогу, у якому має залишатися шлях, виконується як зазвичай.

Повідомлення, що виводиться. Його відкриває власне речення умови, потім іде шлях, який операція збиралася записати чи видалити, — writing або removing вказує, що саме, — каталог, у якому він має залишатися, посилання, яке трапляється на шляху, і місце, куди це посилання веде, а потім спосіб виправлення. Збірку, у якої dist є посиланням за межі робочого простору, зупиняє перше, чого вона торкнулася б, — очищення попереднього виводу:

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 (шлях, який ця операція записує чи видаляє, веде через посилання за межі каталогу, у якому має залишатися. У цей шлях нічого не записано й із нього нічого не видалено. Видаліть посилання або спрямуйте його в місце всередині робочого простору й запустіть операцію знову)

Діагностика не має категорії: причина помилки — структура на диску, а не будь-який написаний вами документ.

Як виправити: видаліть посилання, назване в повідомленні, і запустіть операцію знову, щоб вона створила в цьому місці справжній каталог чи файл; або спрямуйте посилання кудись усередину каталогу, названого в повідомленні, де за ним буде виконано перехід. Ніщо у ваших файлах сутностей цього не спричиняє, і жодна зміна в них цього не усуне.

A name the operation writes holds a part Windows cannot hold (Ім’я, яке записує операція, містить частину, яку Windows не може зберегти)

У Windows деякі імена не доходять до файлу в тому вигляді, у якому їх записано. Ім’я, яке Windows резервує для пристрою, — CON, PRN, AUX, NUL, CONIN$, CONOUT$, від COM0 до COM9 і від LPT0 до LPT9, а також імена COM і LPT, записані з надрядковою одиницею, двійкою чи трійкою, — називає пристрій, а не файл, у будь-якому регістрі літер і з будь-яким розширенням після нього, тож nul, Aux.yaml і com1.txt — усе це пристрої. А частину шляху, що закінчується крапкою або пробілом, Windows може обрізати замість того, щоб зберегти як записано. Запис такого імені помістив би його байти не туди, куди вказує ім’я файлу.

Тому там, де операція збирається записати в каталог на машині з Windows ім’я, якого вона не обирала сама, ім’я з такою частиною відхиляється ще до будь-якого запису: запис архіву, який несе артефакт джерела або сутність каталогу, коли кеш розгортає архів для читання; файл, який збірка рендерить у свій вихідний каталог; чернетка, яку імпортер повертає aggrega import, як під час пробного запуску, так і під час запису; і документ, який записує назад aggrega edit-document, хоч би яка поверхня запросила редагування. Оцінюється кожна частина імені, причому зворотна скісна риска читається як роздільник, так, як її читає Windows, — тож aux/x.yaml відхиляється через свій каталог aux, report. — через кінцеву крапку, а .. \evil.yaml — через першу частину, дві крапки й пробіл. Набір, відхилений через одне ім’я, не записує жодного з інших: архів не розгортається, вихідні дані збірки не очищаються й не записуються, і жодна чернетка не потрапляє на диск.

У Linux і macOS ті самі імена записуються так, як їх названо, і ця умова ніколи не спрацьовує. Ім’я, що виходить за межі каталогу, у який його записують, — це інша помилка, яку відхиляє на кожній платформі власне повідомлення відповідної операції ще до перевірки цієї умови.

Повідомлення, що виводиться. Воно починається власним реченням умови, далі йдуть ім’я, частина, яку Windows не може зберегти, і каталог, у який мало бути записано ім’я, а потім спосіб виправлення:

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 (ім’я, яке записує ця операція, містить сегмент шляху, який Windows не може зберегти як записано (ім’я, його сегмент, у каталозі). Його не записано. Windows резервує імена пристроїв, як-от CON, PRN, AUX, NUL, COM1 і LPT1, у будь-якому регістрі літер і з будь-яким розширенням, і не зберігає як записано сегмент, що закінчується крапкою або пробілом; перейменуйте цей сегмент там, де створюється ім’я)

Діагностика не має категорії: ім’я походить від того, що його створило, — видавця архіву, Recipe чи бібліотеки, імпортера, шляху, який називає редагування, — а не від одного документа, до якого компілятор відносить помилку.

Як виправити: перейменуйте частину, яку називає повідомлення, там, звідки походить ім’я. Для запису архіву це опублікований артефакт джерела або сутність, які може змінити лише їхній видавець. Для відрендереного файлу це вихідне ім’я, яке дає йому Recipe або ArtifactLibrary; для чернетки — імпортер, що її назвав; для редагування — шлях документа. Ніщо в налаштуваннях машини з Windows не зробить ім’я придатним у записаному вигляді.

Умови, що не зупиняють збірку

Кожна з наведених вище умов зупиняє збірку. Деякі умови мають власний короткий код і повідомлення, але ніколи її не зупиняють; їх зібрано тут, щоб код, який ви маєте, завжди до чогось вів, з якої б сторінки ви не прийшли.

Вони поділяються на чотири види, і різницю між ними варто знати, перш ніж шукати виправлення.

  • Застереження. Збірка повідомляє про нього й продовжує роботу, а результат рендерингу однаковий незалежно від того, чи ви на нього зреагуєте. Кожне повністю описано на сторінці warnings.md — що його спричиняє, на якому етапі компіляції воно перевіряється, що виводить і що з ним робити, — а записи нижче вказують відповідний розділ замість того, щоб повторювати його тут.
  • Умова, яку поглинає редактор. На неї відповідає сама інтеграція з редактором, і вона не потрапляє ні у вивід збірки, ні в діагностику.
  • Запобіжник за попередньою відмовою. Правило, яке він захищає, ще раніше забезпечує умова, що таки зупиняє збірку, тож збірка першою натрапляє саме на неї.
  • Відмова в команді, яка не є збіркою. Це жорстка зупинка з реальним способом виправлення — вона завершує команду, що на неї натрапила, і нічого не публікується, не записується й не змінюється, — але жоден етап компіляції до неї не доходить, тож жодна збірка про неї не повідомляє. На такі відмови натрапляють під час публікації або підписання артефакту, закріплення вхідних даних сутності, додавання реєстру, редагування документа, перетворення зовнішнього опису джерела на чернеткові авторські файли та перевірки всього каталогу — на коректність або на відповідність домовленостям публікації; кожен запис указує, до якої команди він належить і хто може це виправити.

Прив’язка анотації оголошує один шлях в обох списках опор

Застереження. Прив’язка анотації в сутності Manifest називає той самий шлях із крапками і у своєму списку maps.infra, і у списку maps.values. Оголошувати таке перекриття дозволено, і компілятор його не контролює: правило розв’язання нічиєї під час маршрутизації детерміновано спрямовує шлях через infra, через що бік values цього шляху стає недосяжним із сутності Aggregate.

Його повідомлення починається так:

annotation binding declares one path in both pillar lists (прив’язка анотації оголошує один шлях в обох списках опор)

Саме воно попереджає вас, перш ніж збірка натрапить на зупинку, описану вище в розділі «An annotation routes through a pillar its authoring side may not use», — застереження є ранньою ознакою, а та зупинка забезпечує правило. Цю перевірку описано в розділі «Binding-map-overlap lint» на сторінці warnings.md.

Назва вкладення на одне редагування відрізняється від оголошеного слота

Застереження. Компонент приєднує Feature під назвою, яка не є одним з оголошених слотів його типу, але відрізняється від одного з них лише на одне редагування, — так виглядає описка в назві слота. Вкладення під назвою, якої не оголошує жоден слот, дозволене, тож нічого не зупиняється; застереження вказує на наслідок: вкладення є вільним, а не заповненням слота, який ви мали на увазі, і слот залишається порожнім. У з’єднанні та сама описка не дозволена і натомість зупиняє збірку, називаючи близький слот; див. «A connection carries an attachment under a name its socket declares no slot for». Якщо Feature вкладення задовольняє selector: близького слота, застереження не виникає: таку пару оцінює зупинка з розділу «An attachment written under another name fits a slot its component leaves empty», яка повідомляє про неї, коли слот залишається порожнім.

Його повідомлення починається так:

attachment name is a near miss for a declared slot (назва вкладення майже збігається з оголошеним слотом)

Описано в розділі «Attachment-slot near-miss lint» на сторінці warnings.md, разом із порогом зіставлення та тим, чого перевірка навмисно не виявляє.

Назва сокета uses: на одне редагування відрізняється від оголошеного сокета

Застереження. Власний блок uses: компонента називає сокет, якого його тип не оголошує, але який відрізняється від одного з оголошених лише на одне редагування. Розробник володіє топологією, яку оголошує Aggregate, і може назвати сокет, якого каталог не передбачив, тож назва сокета, не оголошена типом, на цьому рівні дозволена, і нічого не зупиняється. Застереження вказує на наслідок: назва з опискою створює власне довільне з’єднання без селектора й без контракту для ребра, а сокет, який ви мали на увазі, залишається непідключеним.

Його повідомлення починається так:

uses socket name is a near miss for a declared socket (назва сокета uses майже збігається з оголошеним сокетом)

Описано в розділі «Uses-socket near-miss lint» на сторінці warnings.md. Два суміжні рівні, на яких назва сокета, відсутня в usesSchema сутності-власника, таки зупиняє збірку, описано вище в розділі «uses: socket not declared in the owning entity’s usesSchema (сокет не оголошено в сутності-власнику)».

Сутність Recipe публікує ключ provides, якого не оголошує її Component

Застереження. Сутність Recipe, прив’язана до компонента, публікує в provides: ключ, якого тип компонента не оголошує у своєму контракті spec.schema.provides:. Публікувати більше, ніж оголошує Component, дозволено й надалі буде дозволено — контракт вимагає підмножини й допускає надмножину. Застереження вказує на наслідок, невидимий з жодного боку: споживач, що читає через ребро uses:, бачить оголошений контракт цілі, а не те, що виводить її Recipe, тож неоголошений ключ не доставляється, і шаблон-споживач, що його читає, рендерить порожнє значення.

Його повідомлення починається так:

Recipe publishes a provides key its Component does not declare (Recipe публікує ключ provides, якого не оголошує її Component)

Протилежний випадок не є застереженням: Component, що оголошує ключ, якого не публікує його Recipe, залишає контракт невиконаним і зупиняє збірку. Описано в розділі «Undeclared-provides-key lint» на сторінці warnings.md.

Оголошений параметр ніщо не читає

Застереження. Сутність Aggregate оголошує запис у spec.parameters:, але жодне посилання {{ .parameters.<key> }} у власному тексті цієї Aggregate його не читає, тож хоч би що для нього надала сутність Release, результат рендерингу однаковий. Компілятор не контролює, які налаштування відкриває автор, а параметр можна цілком законно оголосити раніше за посилання, яке його читатиме, тому це лише застереження, а не зупинка.

Його повідомлення починається так:

declared parameter is read by no reference in the Aggregate (оголошений параметр не читає жодне посилання в Aggregate)

Описано в розділі «Unread declared-parameter warnings» на сторінці warnings.md, зокрема чому значення за замовчуванням не є винятком і які посилання перевірка може й не може бачити.

Прив’язка провайдера називає можливість, яку не обслуговує жоден плагін, що його читає збірка

Застереження. Запис plugins.providers називає можливість без плагіна, і жоден із плагінів-провайдерів, які читає збірка, — у каталогах, усередині компілятора чи серед записаних у lock-файлі — цієї можливості не обслуговує. Так виглядає описка в назві можливості, і такий запис ніщо не читає: прив’язку враховують лише тоді, коли Recipe запитує її можливість, а прив’язка без плагіна не вибирає нічого, чого розв’язання можливості не вибрало б і без неї.

Це застереження, а не зупинка, бо збірка не може бути певною. Прив’язки записують один раз для всього робочого простору, а збірка стосується однієї сутності Release, тож плагін, що обслуговує можливість, може читати лише інша Release. Запис, що називає плагін, оцінюється інакше й зупиняє збірку там, де він напевно хибний, — див. вище «A plugins.providers binding names a plugin that does not serve the capability».

Його повідомлення починається так:

plugins.providers entry names a capability no provider-rendering plugin the build reads serves (запис plugins.providers називає можливість, яку не обслуговує жоден плагін рендерингу провайдера, що його читає збірка)

і далі містить можливість та обслуговувану можливість, що відрізняється на одне редагування, якщо така є. Описано в розділі «Provider-binding unserved-capability warning» на сторінці warnings.md.

Позиція в редакторі виходить за межі документа

Умова, яку поглинає редактор. Функції редактора, що залежать від положення курсора, — перехід до визначення, підказка під час наведення, автодоповнення — спершу знаходять курсор у розібраній структурі документа. Цю умову повідомляє саме цей крок, коли позиція вказує на рядок, якого в документі немає. Таке трапляється тимчасово, поки редагування триває, а позицію, яку надіслав редактор, обчислено щодо тексту, від якого документ уже відійшов.

Її повідомлення:

position out of range (позиція поза діапазоном)

Вона не доходить ні до збірки, ні до діагностики. Кожна функція, яка може натрапити на неї, відповідає порожнім результатом, а не показує помилку. Саме такої поведінки вимагає протокол редактора: запит, на який не можна відповісти, нічого не повертає, і редактор надсилає його знову після наступного натискання клавіші.

У ваших файлах нічого виправляти не треба, і в збірці нічого не з’являється. Якщо функція так і не відповідає, а не відновлюється після наступного редагування, про це варто повідомити як про дефект.

Власна перевірка вхідних даних кроку злиття схем

Перевірка, до якої збірка не доходить. Коли сутність Component або Feature розширює іншу і обидві оголошують схеми, ці схеми об’єднуються в одну. Бібліотека, що виконує об’єднання, відхиляє вхідні дані, які не може злити структурно:

merger: invalid merge input (некоректні вхідні дані для злиття)

Вона належить до кроку об’єднання, до якого збірка доходить щоразу, коли сутність, що розширює, та її база обидві оголошують схеми. Ця перевірка захищає від порожнього ланцюжка або від елемента ланцюжка без схеми, — і викликач не може передати ні того, ні іншого: він складає ланцюжок лише зі схем, наявність яких уже встановив, і виконує об’єднання лише тоді, коли ланцюжок вийшов непорожнім.

Перевірку збережено, бо це відмова експортованої бібліотеки приймати некоректні вхідні дані. Її вилучення не прибрало б жодної зупинки, до якої може дійти збірка; воно перетворило б чітку відмову на аварійне завершення для викликача поза компілятором, який передав такі дані, а це однозначно гірше.

Сам ланцюжок не є предметом цього кроку. Ланцюжок, що зациклюється, і ланцюжок, що виходить за межу глибини, відхиляє єдиний обхід extends: ще до того, як буде об’єднано будь-яку схему, — див. «Cyclic extends chain (Циклічний ланцюжок extends)» і «An extends: chain runs past the depth bound (Ланцюжок виходить за межу глибини)» вище.

Її внесено до каталогу, бо вона оголошена й має власний код, тож код, який ви маєте, знаходить відповідник. Жоден написаний вами вміст її не спричиняє, а якщо ви на неї натрапили, це означає, що описаний вище устрій більше не виконується, — про це варто повідомити як про дефект, а не обходити.

Явне значення витіснило значення, надане анотацією

Попередження. Розгортання на основі анотацій перетворює анотацію, яку має Aggregate або Release, на прикріплення Feature з власною конфігурацією. Якщо те саме прикріплення має також явно записану конфігурацію — на компоненті, в області видимості над ним або в Release, — явне значення перемагає для кожного ключа, який охоплюють обидва. Це передбачене правило, і згенерований вихід не помилковий, тож збірка завершується. Попередження вказує на наслідок: внесок анотації до цього ключа ніде у виході більше не видно, і автор анотації може не знати, що її придушено.

Воно повідомляє про кожне витіснення, а не лише про ті, що щось змінили. Злиття перезаписує придушене значення, тож порівнювати вже нічого і немає чим визначити, чи збігалися ці два значення, — запис про те, що витіснення сталося, і є всім доказом. Його зчитують, щойно весь каскад прикріплень і розгортання об’єднано, а це найраніший момент, коли такий запис існує.

Його повідомлення починається так:

annotation contribution overridden by an explicit value (внесок анотації перевизначено явним значенням)

і далі називає витіснену анотацію, потім координати ключа, що її витіснив, потім місце, де витіснену анотацію записано. Позиція перед ним — це документ, у якому міститься знахідка, і ключ у ньому:

<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>") (внесок анотації перевизначено явним значенням)

Два з цих значень легко неправильно зрозуміти. component указується лише тоді, коли запис, що витісняє, має компонент: запис для цілої області видимості власного компонента не має, і назва компонента, якого в нього ніколи не було, відправила б читача до ключа, якого ніхто не писав. А annotation declared at указує, де записано витіснену анотацію, — це область видимості, з якої її успадковано, якщо її не записано на компоненті, що її витіснив, — тож це не повтор ключа компонента під іншим підписом.

Що з цим робити: нічого, якщо ви мали на увазі саме явне значення. Попередження існує для того, щоб пріоритет був вибором, а не несподіванкою. Якщо ви мали на увазі інше, є два виходи, і вони різняться охопленням. Вилучіть явний запис — і значення анотації дійде до цього ключа. Або вилучіть анотацію з компонента чи області видимості, де вона є, — і жодного внеску не буде взагалі, що також зачіпає кожен інший ключ, який надає ця анотація. Якщо потрібні обидві сторони, але для різних ключів, звузьте ту, що сягає далі, ніж задумано, щоб вони більше не перетиналися.

З’єднання перетинає межу між зібраними виходами двох різних провайдерів

Коли два кінці з’єднання залежності збираються в різні виходи, провайдер, який заявляє підтримку зв’язування через межі, з’єднує їх нативно — публікує посилання на стороні-постачальнику й розв’язує його на стороні-споживачі. Таке з’єднання записано власною лексикою одного провайдера, і провайдер не може розв’язати посилання, опубліковане іншим. Тож з’єднання, два кінці якого рендеряться через різних провайдерів, не з’єднує жоден із них.

Це попередження, і воно не зупиняє збірку. З’єднання все одно передає своє значення: контракт ін’єкції передає скалярне значення сторони-постачальника на сторону-споживача точно так само, як і будь-де інде, тож у результаті є робоче з’єднання, виконане звичайним способом, а не зламане. Знахідка повідомляє, що нативного з’єднання, на яке ви могли очікувати, не відбулося, — а вихід однаковий незалежно від того, чи ви щось зробите.

Для повідомлення достатньо одного провайдера, що заявляє зв’язування. Обидва кінці не зобов’язані цього заявляти: одна заява означає, що нативне з’єднання очікувалося і є неможливим, а автор, який прикріпив цього провайдера, саме його і хотів. Вимога обох заяв нічого не повідомила б у звичайному змішаному розгортанні, де один провайдер зв’язує, а інший ні, — а саме для цього випадку це й призначено.

Розміщення кінців не враховується. Зібраний вихід ідентифікується шляхом і провайдером разом, тож два кінці з різними провайдерами завжди перебувають у різних виходах, хоч би де їх розміщено. Зчитуються лише два провайдери та їхні дві заяви.

Про це повідомляється один раз для кожного такого з’єднання, з позицією в документі й ключі, де з’єднання записано.

Повідомлення, яке видається, спершу називає дальній кінець, а потім сокет і провайдера кожного кінця:

cross-boundary link between endpoints rendered by different providers is not supported ("<target-component>", socket "<socket>", consumer provider "<provider>", target provider "<provider>") (зв’язування через межі між кінцями, які рендерять різні провайдери, не підтримується)

Як виправити: якщо скалярного значення, яке з’єднання вже передає, достатньо, нічого робити не треба — це сповіщення, а не збій. Якщо потрібне нативне з’єднання, обидва кінці мають рендеритися через одного провайдера: перемістіть один кінець у межу, що маршрутизується через провайдера іншого, або обслуговуйте обидві можливості одним провайдером. Якщо жодне з цього неможливе, розгортання має форму з передаванням значення, і з’єднання працює.

Засіб запуску плагінів командного рядка зібрано без способу знаходити плагіни

Плагін, який додає команду терміналу, запускається компонентом, що спершу має перетворити посилання на плагін на байти. Ця умова повідомляє, що цей компонент зібрано без частини, яка виконує це перетворення, тож від посилання немає шляху до того, що можна запустити.

Вона стосується команди терміналу, а не збірки, тому жоден етап компіляції до неї не доходить: вона виникає там, де диспетчеризується встановлена команда, і її результат — це те, що команда не запускається, а не зупинка будь-якої збірки.

Жоден шлях у постачуваному інструменті командного рядка не може її викликати. Кожне місце, де інструмент збирає цей компонент, надає механізм пошуку, тож захист спрацьовує лише там, де компонент збирає щось інше й не надає цього механізму.

Повідомлення, яке видається, — це власне речення цієї умови:

cliplugin: no plugin resolver configured (cliplugin: не налаштовано розпізнавача плагінів)

Як виправити: це спричиняє ніщо у ваших файлах сутностей, і ніщо, що ви можете написати в каталозі чи робочому просторі, цього не усуває. Якщо ви запускаєте опублікований інструмент командного рядка, ця умова для вас недосяжна — встановлена команда, яка не запускається, повідомляє про щось інше, і читати слід саме надруковане нею повідомлення. Якщо ви вбудовуєте засіб запуску плагінів у власне програмне забезпечення, під час його створення надайте механізм пошуку, який перетворює посилання на плагін на його байти.

Псевдонім реєстру вже прив’язано до іншого хоста

Відмова під час додавання реєстру до робочого простору, а не під час збірки. Псевдонім — це коротке ім’я, яке вибирає один запис реєстру, тому він унікальний серед записів. Реєстрацію псевдоніма, який уже належить іншому хосту, відхиляють, а не дозволяють їй затінити наявну прив’язку, бо це непомітно змінило б, куди вказує кожне посилання з цим псевдонімом.

Повторне додавання того самого хоста під його наявним псевдонімом не є конфліктом — так запис оновлюється на місці, і саме це відбувається, коли команду запускають повторно, щоб змінити інші налаштування хоста.

Повідомлення, яке видається, з назвою псевдоніма й хоста, якому він уже належить:

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: псевдонім реєстру вже використовується хостом; виберіть інший псевдонім або звертайтеся до цього хоста напряму: псевдонім реєстру вже використовується іншим хостом)

Як виправити: виправлення — справа оператора, у командному рядку. Дайте новому реєстру інший псевдонім або залиште його без псевдоніма й звертайтеся до нього за хостом. Якщо ви хотіли перенести псевдонім на новий хост, спершу видаліть його із запису, названого в повідомленні, у .aggrega-config.yaml — відмова існує для того, щоб перенесення псевдоніма було свідомою дією, а не побічним ефектом додавання реєстру.

Реєстр надає документ довіри, який не вдається прочитати як такий

Відмова під час додавання реєстру, а не під час збірки. Реєстр може публікувати ідентичності підписування, якими, на його думку, мають бути підписані артефакти, щоб під час додавання реєстру їх можна було закріпити, а не змушувати оператора переписувати їх вручну. Ця умова повідомляє про реєстр, який відповів документом, непридатним як політика довіри.

Це жорстка відмова саме тому, що кінцева точка відповіла. Реєстр, який нічого не публікує, — звичайний, очікуваний результат, який допускається; реєстр, що публікує щось нечитабельне, — це помилка конфігурації, і якщо нічого з нього не закріпити, реєстр непомітно лишився б незакріпленим, хоча виглядав би закріпленим.

Тут повідомляється про три випадки: вміст, який узагалі не декодується, зокрема документ із полем, якого формат не визначає; запис ідентичності, що не називає ні точної ідентичності, ні шаблону; і запис ідентичності без видавця. Два останні відхиляються, бо такий запис ніколи не може збігтися з підписом, тож він послабив би закріплення, створюючи враження, що посилює його.

Повідомлення, які видаються. Вміст, що не декодується:

registrytrust: advertised trust config is malformed: <what the decoder reported> (registrytrust: оголошена конфігурація довіри має неправильний формат)

запис ідентичності, у якому немає з чим зіставляти:

registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set identity or identity_regexp (registrytrust: оголошена конфігурація довіри має неправильний формат: запис ідентичності має задавати identity або identity_regexp)

і запис без видавця:

registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set issuer (registrytrust: оголошена конфігурація довіри має неправильний формат: запис ідентичності має задавати issuer)

Кожне з них обрамлене командою, яка на нього натрапила:

aggrega registry add: <the message above>

Як виправити: виправлення належить тому, хто обслуговує реєстр, а не вам — перешліть йому повідомлення, адже воно називає точний запис і те, чого в ньому бракує. Щоб тим часом продовжити, додайте реєстр без закріплення його оголошеної політики й самостійно надайте ідентичності або ключ; команда приймає їх напряму, і саме так ви робите й для реєстру, який узагалі не публікує політики.

Реєстр не публікує документа довіри

Звичайний, очікуваний результат, а не збій, і він нічого не зупиняє. Реєстр може публікувати ідентичності підписування, яких очікує, і більшість цього не роблять. На запит такий реєстр відповідає, що документа немає, і додавання реєстру триває — результат повідомляється як примітка, а ідентичності натомість закріплюються вручну.

Цей випадок навмисно відрізняється від реєстру, до якого не вдалося дістатися. Цей реєстр відповів; відповідь полягала в тому, що він не публікує політики. Розмежування цих випадків дає змогу допускати навмисну відсутність, водночас лишаючи проблему досяжності видимою як таку.

Повідомляється як примітка, що називає реєстр, його відповідь і що зробити натомість:

Notice: <host> publishes no trust policy (HTTP 404); pin its trust by hand with —identity or —key (Примітка: реєстр не публікує політики довіри (HTTP 404); закріпіть довіру до нього вручну за допомогою —identity або —key)

Умова, під якою це записано, — registrytrust: registry advertises no trust config.

Виняток — офіційний хаб: він має вбудовану базову політику, тож коли він не публікує документа, натомість закріплюється ця базова політика, а примітка повідомляє, що відповів хаб і що замість документа використовується базова політика, а не просить вас закріпити ідентичності.

Як виправити: нічого не зламано. Якщо ви хочете, щоб підписи з цього реєстру перевірялися, надайте ідентичність або ключ під час його додавання, точно як каже примітка, — це звичайний шлях для реєстру, який не публікує політики. Якщо ні, реєстр додається без позиції щодо підписування, а артефакти з нього перевіряються лише тоді, коли мають підпис.

Реєстр додається в офлайн-режимі без політики довіри, яку можна закріпити

Відмова під час додавання реєстру, а не під час збирання. Додавання реєстру — єдиний момент, коли закріплюється довіра до нього: підписувальні ідентичності, які він оголошує, завантажуються один раз, і кожне подальше отримання перевіряється за цією закріпленою копією. Коли робочий простір перебуває в офлайн-режимі, це завантаження неможливе, тож до реєстру не звертаються. Замість того щоб записати запис, який нічому не довіряє, — і якого кожне подальше отримання вимагало б від реєстру, — додавання будь-якого реєстру, крім офіційного хабу, відхиляється, якщо ви не надасте політику самостійно.

Три випадки не відхиляються. Якщо надати ідентичності або ключ, реєструються саме вони й жодного завантаження не відбувається, тож це працює однаково в офлайн- та онлайн-режимі. Офіційний хаб додається на основі своєї вбудованої базової політики, яку він має незалежно від того, чи відбувається завантаження. А запит без завантаження — --fetch-trust=false — реєструє запис за прапорцями, так само як і в онлайн-режимі.

Ця умова виникає скрізь, де додається реєстр: aggrega registry add, aggrega config init --registry <host>, запити aggrega/registryAdd і aggrega/configInit до aggrega serve, повідомлення про помилку яких містить короткий код перед реченням, а також інструменти реєстрації aggrega mcp, які виконують ці команди. Початкове створення конфігурації не приймає ідентичностей чи ключа, тож в офлайн-режимі воно може додати лише хаб; будь-який інший реєстр додавайте натомість через aggrega registry add.

Повідомлення, яке видається, — це власне речення цієї умови:

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> (реєстр, відмінний від офіційного хабу, не реєструється в офлайн-режимі без політики довіри, наданої вручну, оскільки оголошену ним політику неможливо завантажити; зареєструйте його один раз в онлайн-режимі або закріпіть довіру до нього вручну)

у рамці команди, яка на неї натрапила, і реєстру, який вона називає:

aggrega registry add: <host>: <the message above>

Як виправити: зареєструйте реєстр один раз, коли робочий простір в онлайн-режимі, — передайте --offline=false для цього одного запуску або вимкніть налаштування offline, — щоб його оголошену політику було завантажено й закріплено; згодом нічого повторювати не потрібно, оскільки подальші отримання перевіряються за закріпленою копією. Якщо вийти в онлайн неможливо, надайте політику вручну: один або кілька записів --identity <identity>=<issuer> для реєстру без ключів або --key, що вказує на файл його відкритого ключа, для реєстру з ключем, — саме це ви закріпили б з його оголошення.

Тег уже опубліковано з іншим вмістом

Відмова під час публікації, а не під час збирання. Опубліковані байти незмінні: перед будь-яким завантаженням цільову версію знаходять і порівнюють дайджест, на який вона вказує, з дайджестом, який дав би наявний вміст. Версія, що вже вказує на інший вміст, відхиляється.

Повторна публікація побайтово ідентичного вмісту не є конфліктом. Дайджести збігаються, нічого не завантажується, і команда повідомляє, що версію вже опубліковано, — тож повторний запуск частково успішної публікації безпечний і завершує її: додаються дата публікації, якої версії ще бракує, та її підпис, якщо надсилання підписує, а версія, якій не бракує ні того, ні іншого, нічого не отримує, як описано в розділі Завершення публікації, яку попереднє надсилання залишило частковою.

Прапорця, який би це скасовував, немає. Змінений вміст публікується під новою версією — саме це залишає споживачам версію, на яку можна свідомо перейти, а не версію, що змінилася без їхнього відома.

Повідомлення, які видаються, називають версію, дайджест, який вона містить, і запропонований дайджест. Під час публікації сутності каталогу, де також називається перевірка, що підтверджує підвищення версії:

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 (уже опубліковано як …; відмова перезаписати … — опублікуйте нову версію (aggrega lint —pre-publish перевіряє підвищення версії): oci: тег уже опубліковано з іншим вмістом)

і під час публікації артефакту даних:

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 (уже опубліковано як …; відмова перезаписати … — опублікуйте нову версію: oci: тег уже опубліковано з іншим вмістом)

Як виправити: підвищте версію та опублікуйте знову. Для сутності каталогу це означає metadata.version і каталог конкретної версії, у якому лежить сутність, — вони змінюються разом. Перед цим переконайтеся, що зміна навмисна: якщо дайджести відрізняються для версії, якої ви, на вашу думку, не торкалися, то вміст на диску не той, що було опубліковано, і з’ясувати причину важливіше, ніж опублікувати поверх нього. Перевірка перед публікацією, названа в повідомленні, порівнює версію з попередньою і дає змогу підтвердити, що підвищення правильне.

Сутність ділить свій каталог з іншою сутністю

Відмова під час закріплення та публікації, а не під час збирання. Кожен вид сутності має власний каталог, окрім трьох, які корінь робочого простору містить поруч: Aggregate, Release і Manifest. Опублікована сутність — це один артефакт за однією координатою для кожної версії, і каталог, у якому її створено, це відображає: крок закріплення записує єдиний entity.lock, для якого в каталозі є місце, а публікація пакує сутність з її каталогу. Тому сутність будь-якого іншого виду, поруч з якою є інша сутність, відхиляється в обидва ці моменти: командою aggrega pin, отриманням чи надсиланням, яке має виконати закріплення від імені автора, і командою aggrega push незалежно від того, чи вона закріплює. Відмова відбувається до будь-якого завантаження, і нічого не записується.

Каталог із кількома сутностями все одно завантажується, перевіряється лінтером, валідується та збирається. Структура оцінюється лише тоді, коли з каталогу щось створюється, — саме тоді повідомлення може назвати сутність, яка заважає. Отримання без закріплення нічого не записує поруч із сутністю і не відхиляється.

Сутністю поруч вважається будь-який інший YAML-документ безпосередньо в тому самому каталозі, чий kind: є видом сутності. Власні файли чарту, фрагмент compose, маніфест Kubernetes чи README не є сутностями, а підкаталог — локальний чарт, дерево source/ — не перебуває поруч із сутністю, хоч би що він містив. Зчитуються лише вид та ім’я кожного сусіда, тож ніщо, оголошене сусідом, не може змінити результат.

Назва каталогу не оцінюється. Сутність, сама у своєму каталозі, закріплюється й публікується з оголошеною версією, де б цей каталог не розташовувався; структура <name>/<version>/, яку використовує каталог стандартної бібліотеки, — це домовленість, а не перевірка.

Повідомлення, яке видається, називає сутність, кожну сутність поруч із нею та файли, які слід перемістити:

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 (сутність ділить свій каталог з іншою сутністю, а сутність її виду має власний каталог (Recipe, поруч: Recipe у файлі). Виправлення: надайте кожній сутності власний каталог — перемістіть файл до власного каталогу разом із будь-яким файлом, який читає лише ця сутність; ділити каталог з іншими сутностями можуть лише види Aggregate, Manifest і Release)

Як виправити: перемістіть кожну сутність, названу в повідомленні, до власного каталогу разом із файлами, які читає лише вона, — локальним чартом, імпортованим файлом і entity.lock, якщо він записує закріплення цієї сутності, — і виконайте aggrega pin для кожної, що читає віддалене джерело або імпортує файл, щоб кожен lock-файл записував власну сутність. Структура <kind>/<provider-or-publisher>/…/<name>/<version>/ розміщує сутність там, де каталог стандартної бібліотеки тримає кожну сутність. Каталог знаходиться обходом, тож збирання за каталогом після переміщення дає той самий результат.

An entity kind has no artifact media type (Вид сутності не має медіатипу артефакту)

Відмова під час публікації, а не під час збірки. Кожен вид сутності, який можна публікувати, має медіатип для кожної з двох форм свого артефакту — лише документ або архів документа з оголошеними в ньому файлами, — і пакування сутності шукає його за видом. Ця умова повідомляє про вид без запису.

Жодна збірка до цього не доходить. Єдине інше місце, де виконується той самий пошук, трактує відсутній запис як «це не бібліотека» і продовжує роботу, тож там умова ніколи не проявляється.

Повідомлення, що видається: власне речення умови, обрамлене командою та файлом, який пакувався:

aggrega push: bundle <path>: oci: unknown entity kind for mediatype dispatch (aggrega push: пакет: oci: невідомий вид сутності для вибору медіатипу)

Як виправити: звірте поле kind: файлу, який ви публікуєте, з видами, які виводить aggrega push --list-kinds: тут повідомляється про вид із помилкою в написанні або непідтримуваний, і виправлення поля — це все, що потрібно. Якщо цей вид є в тому списку, це прогалина в інструментарії, а не у вашій сутності, і про неї варто повідомити, навівши вид.

A published archive carries an entry Windows cannot use (Опублікований архів містить запис, який Windows не може використати)

Застереження, що з’являється під час публікації сутності; воно ніколи нічого не зупиняє, і збірка його не видає. Сутність, яка несе файли поруч зі своїм документом, публікується як архів, і кожна назва в архіві — власна назва файлу документа сутності, а потім кожного файлу, який вона несе, — оцінюється за правилом, яке зупинка «A name the operation writes holds a part Windows cannot hold» вище застосовує у Windows: частина, яку Windows резервує для пристрою, у будь-якому регістрі й з будь-яким розширенням, або частина, що закінчується крапкою чи пробілом. Тож aux/x.yaml спричиняє його через каталог aux, report. — через кінцеву крапку, а документ із назвою con.yaml, що імпортує файл схеми, — через власну назву. Сутність, яка нічого не несе, публікується лише як документ під назвою, яку обирає продукт, а Plugin не публікує архіву, тож жодна з них його не спричиняє.

Воно видається на кожній платформі й нічого не відхиляє. Робочий простір у Windows відмовляється розгортати такий запис через цю зупинку, тож не може використати цю версію; застереження дає змогу видавцеві дізнатися про це раніше, ніж хтось у Windows. Публікація або її пробний запуск продовжується чи зупиняється точно так само, як і без нього.

Кожен інтерфейс, що публікує сутність, видає його, кожен у своїй формі. aggrega push і його --dry-run виводять по одному рядку на запис у стандартний потік помилок, кожен із початком warning: . Інструмент асистента publish-entity повертає записи як windows_unusable_entries, і текст відповіді теж їх називає. aggrega serve відповідає на aggrega/publishEntity із ними як windowsUnusableEntries і передає самі рядки попереджень запиту, який просив про звітування. Кожна відповідь пропускає поле, якщо таких записів немає.

Його повідомлення починається так:

an entry this publication carries cannot be used on Windows (запис, який несе ця публікація, не можна використати у Windows)

і продовжується записом і першою з його частин, яку Windows не може містити, а потім виправленням. Пояснено в розділі «A published archive carries an entry Windows cannot use» у warnings.md.

Як виправити: перейменуйте частину, названу в повідомленні, на диску й усюди, де оголошення сутності називають файл, і опублікуйте знову. Якщо версію не призначено для використання у Windows, нічого змінювати не потрібно.

Two catalog identities publish to one repository location (Дві ідентичності каталогу публікуються в одне розташування репозиторію)

Відмова під час перевірки всього каталогу, а не під час збирання. Місце, куди публікується сутність, виводиться з її ідентичності й переводиться в нижній регістр, тож дві ідентичності, що відрізняються лише регістром літер, потрапляють в одне місце. Публікація обох призвела б до того, що байти однієї сутності було б перезаписано байтами іншої, і ніщо в жодній із сутностей про це б не свідчило.

Перевірка виконується одразу для всього каталогу, бо колізія — це властивість пари, а не кожної сутності окремо: жодна з них не є помилковою сама по собі, і читання будь-якої з них ізольовано нічого не показує.

Повідомлення, яке видається. Воно починається обрамленням перевірки каталогу, потім іде власне речення цієї умови, а далі — кожна група колізій, і кожна називає спільне розташування та ідентичності, що до нього потрапляють:

catalog validation failed: oci: distinct catalog identities map to the same OCI repository location: (перевірка каталогу не вдалася: oci: різні ідентичності каталогу відображаються в одне й те саме розташування репозиторію OCI:)

  • <location> <- <identity>, <identity>

Як виправити: перейменуйте одну із сутностей, названих у повідомленні, у її metadata.name і в каталозі, що його віддзеркалює. Яку саме перейменувати — вирішувати вам; найпоширеніший випадок — пари, що відрізняються лише регістром, і вибір одного написання та послідовне його використання не дає парі виникнути знову. Перейменування — це справжня зміна ідентичності сутності, тож усе, що посилається на стару назву, має змінитися разом із нею; тому колізію варто усунути до того, як будь-яку з назв опубліковано, а не після.

Keyless signing was asked for without the services it needs (Безключове підписування запитано без потрібних йому сервісів)

Відмова під час підписування при публікації, а не під час збирання. Безключове підписування не має офлайн-форми: воно отримує ідентичність, отримує для неї короткоживучий сертифікат, записує підпис туди, де його можна буде перевірити пізніше, а потім знищує ключ. Кожен із цих кроків — це обмін із запущеним сервісом. Ця умова повідомляє, що ідентичність, з якої починається процес, була недоступна, тож процес відхиляється, а не починається й переривається на півдорозі.

Її повідомляють два випадки: взагалі нічого не налаштовано для надання ідентичності, або щось налаштовано, але воно нічого не повернуло.

Офлайн-робочий простір повідомляє інакше, через відмову, що охоплює кожен мережевий крок, бо ця відмова відбувається ще до того, як ідентичність узагалі запитано.

Повідомлення, які видаються. Немає джерела ідентичності:

signing: keyless signing requires a live identity provider, Fulcio, and Rekor: an identity token source is required (підписування: безключове підписування потребує працюючого постачальника ідентичності, Fulcio і Rekor: потрібне джерело токена ідентичності)

і джерело, яке нічого не повернуло:

signing: keyless signing requires a live identity provider, Fulcio, and Rekor: an identity token is required (підписування: безключове підписування потребує працюючого постачальника ідентичності, Fulcio і Rekor: потрібен токен ідентичності)

Як виправити: виправлення — справа оператора, у тому, як запускається публікація. В автоматизованому конвеєрі ідентичність надходить із власних облікових даних конвеєра, тож зазвичай це означає, що завданню не надано дозволу, який їх видає. Під час інтерактивного запуску ідентичність надходить із входу в систему, який команда запропонує виконати. Якщо вам узагалі не потрібна жива ідентичність, підписуйте натомість збереженим ключем: цей шлях не потребує жодного з цих сервісів, і саме його слід використовувати в середовищі, яке не може до них дістатися.

An unsigned publish targets a registry or a policy that requires a signature (Непідписана публікація спрямована до реєстру або політики, що вимагає підпису)

Відмова під час публікації, а не під час збирання. Там, де підпис обов’язковий, непідписаний вміст не публікується. Перевірка виконується до вивантаження будь-яких байтів, тож нічого часткового до реєстру не потрапляє.

Дві умови, бо вимога має два джерела, а способи виправлення різняться. Перше — власна позиція цільового реєстру, що застосовується до всього, що там публікується. Друге — політика підписування робочого простору, що охоплює набір видів артефактів, де б їх не публікували. Коли виконуються обидві, повідомляється умова реєстру, бо назва місця призначення корисніша з двох.

Тут немає прапорця, який публікує непідписаний вміст. Явне вимкнення підписування не послаблює відмову — воно лише змінює типову поведінку для артефактів, де підписування необов’язкове.

Підпис створюється до вивантаження, а не після, тож збій підписування також потрапляє сюди, і нічого не публікується.

Повідомлення, які видаються. Власна вимога реєстру:

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: реєстр вимагає підписів; запустіть повторно, підписавши артефакт (тут немає прапорця для надсилання непідписаного вмісту): підписування: реєстр вимагає підписів; відмова надсилати непідписаний вміст)

вимога політики робочого простору, яка називає вид, через який артефакт потрапив у її охоплення:

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: політика підписування вимагає підпису для виду; запустіть повторно, підписавши артефакт (тут немає прапорця для надсилання непідписаного вмісту): підписування: політика підписування вимагає підпису для цього виду артефакту; відмова надсилати непідписаний вміст)

і підпис, який не вдалося створити, що повідомляється в межах умови реєстру й цитує первинний збій:

aggrega push: sign <reference>:<version>: <the underlying failure>: signing: registry requires signatures; refusing to push unsigned content (aggrega push: підписати: підписування: реєстр вимагає підписів; відмова надсилати непідписаний вміст)

Один випадок збою підписування названо окремо, бо загальна відмова змушує людей повторно отримувати облікові дані, що не допоможе:

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: підписати: токен ідентичності не містить перевіреної електронної адреси чи твердження subject — процес/клієнт OIDC не повернув ідентичність з областю email (повторний експорт чи повторне отримання токена не допоможе); налаштуйте постачальника ідентичності/клієнт/область так, щоб вони її повертали: підписування: реєстр вимагає підписів; відмова надсилати непідписаний вміст)

Як виправити: виправлення — справа оператора. Підпишіть артефакт і опублікуйте знову — або збереженим ключем, або безключовим шляхом, залежно від того, на що налаштовано робочий простір. Якщо ви не очікували, що підпис буде обов’язковим, повідомлення каже, яке джерело його вимагало: власна позиція реєстру міститься в записі цього реєстру в .aggrega-config.yaml, а вимога, прив’язана до виду, — у політиці підписування всього робочого простору. Послаблення будь-якої з них — це рішення про те, що ви готові публікувати без підпису, тож звузити охоплення політики зазвичай краще, ніж вимкнути її.

References signed together need different signing credentials (Посилання, що підписуються разом, потребують різних облікових даних для підпису)

Відмова під час підписування, а не під час збирання. aggrega sign, якому передано кілька посилань, і aggrega deprecate --from, якому передано пакетний файл, підписують усе передане одними обліковими даними: одним збереженим ключем або однією безключовою ідентичністю. Які облікові дані потрібні посиланню, визначає конфігурація його реєстру: signing.key_path, що застосовується до цього реєстру, вибирає вказаний у ньому ключ, а якщо жоден не застосовується, посилання підписується без ключа. Коли посилання, названі разом, потребували б різних облікових даних — ключа для одного реєстру й жодного для іншого або двох різних ключів, — нічого не підписується, а повідомлення називає реєстри з кожного боку.

Перевірка виконується до запиту ідентичності й до читання будь-якого реєстру, тож нічого не підписується й не прикріплюється, і нікого не просять увійти заради запуску, який не відбудеться. Підпис неможливо відкликати в того, хто вже його отримав, тому запуск відхиляється, а не підписується тими обліковими даними, яких потребує одне з посилань.

Ключ, переданий через --key, вирішує для кожного посилання. Він застосовується до кожного названого посилання, хоч би що конфігурація вказувала для кожного реєстру, тож такий запуск тут ніколи не відхиляється.

Ця умова виникає скрізь, де підписується пакет: aggrega sign, aggrega deprecate --from, запити aggrega/signArtifacts і aggrega/deprecateArtifact до aggrega serve, чиє повідомлення про помилку містить короткий код перед реченням, а також інструменти sign-artifacts і deprecate-artifact у aggrega mcp. Виклик інструмента, що надходить до сервера через слухач, ніколи не використовує ключ, названий у конфігурації, тож там кожне посилання підписується ідентичністю, яку надсилає виклик, і виклик тут не відхиляється.

Повідомлення, що виводиться. Воно починається власним реченням умови, далі йдуть усі облікові дані з реєстрами, для яких вони підписували б, а наприкінці — спосіб виправлення:

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 (посилання, названі разом, потребують різних облікових даних для підпису, тому нічого не підписано (реєстр підписує збереженим ключем, який називає signing.key_path, реєстр підписує без ключа: жоден signing.key_path не застосовується). Виправлення: підпишіть їх в окремих запусках, по одному на облікові дані: посилання в одному реєстрі, потім посилання в іншому; кожен запуск підписує так, як підписував би сам по собі)

а якщо реєстр у пакеті вимагає підписів, його названо наприкінці способу виправлення:

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 (посилання, названі разом, потребують різних облікових даних для підпису, тому нічого не підписано (реєстр підписує збереженим ключем, який називає signing.key_path, реєстр підписує без ключа: жоден signing.key_path не застосовується). Виправлення: підпишіть їх в окремих запусках, по одному на облікові дані: посилання в одному реєстрі, потім посилання в іншому; кожен запуск підписує так, як підписував би сам по собі, а реєстр вимагає підписів, тож ця відмова затримує підписування, яке інакше відбулося б, а не підписування, яке неможливе)

Другий реєстр із власним ключем названо таким, що підписує «іншим збереженим ключем» (with a different held key). Шлях до ключа ніколи не виводиться: повідомлення називає параметр, бо саме його ви можете змінити.

Як виправити: розділіть посилання за обліковими даними, яких потребують їхні реєстри, і виконайте по одному запуску на облікові дані — один aggrega sign із посиланнями на реєстри, що підписуються ключем, інший — з рештою; для aggrega deprecate --from — по одному пакетному файлу на облікові дані. Тоді кожен запуск підписує так, як підписував би сам по собі. Щоб натомість підписати всі посилання одним ключем за один запуск, передайте цей ключ через --key.

A detached signature does not verify against the key supplied (Відокремлений підпис не проходить перевірку наданим ключем)

Негативний результат перевірки голого підпису над корисним навантаженням за допомогою відкритого ключа, повністю офлайн: корисне навантаження відрізняється від підписаного, підпис змінено або ключ не той, яким його створено.

Жоден компонент постачуваного інструментарію до цього не доходить. Перевірка, до якої належить ця умова, не має викликів поза власними тестами, тож жодна команда користувача — збирання, pull чи публікація — про неї не повідомляє. Її внесено до каталогу, щоб код вказував на щось, а не тому, що збирання може її вивести. Перевірка, яку справді виконує pull, стосується повного пакета підпису й повідомляється окремо.

Повідомлення, що виводиться, цитує те, що повідомив верифікатор:

signing: signature does not verify: <what the verifier reported> (підпис не проходить перевірку)

Як виправити: ваші файли сутностей цього не спричиняють, і ніщо, що ви можете написати в каталозі чи робочому просторі, цього не усуває. Якщо ви запускаєте опублікований інструмент командного рядка, ця умова для вас недосяжна, а проблему з підписом, яку ви бачите, насправді повідомляє одна з наведених вище умов перевірки пакета. Якщо ви використовуєте пакет підписування безпосередньо з власного програмного забезпечення, корисне навантаження, підпис і ключ мають бути трьома, що належать одне одному — типова причина полягає в повторній серіалізації корисного навантаження між підписуванням і перевіркою, адже тоді байти відрізняються, хоча вміст читається однаково.

A resolved artifact is not a documentation bundle (Розв’язаний артефакт не є пакетом документації)

Посилання, що розв’язується в артефакт іншого виду — сутність каталогу, плагін, — відхиляється, а не кешується як документація, тож хибно спрямоване посилання дає збій там, куди воно спрямоване, а не пізніше як пакет, який неможливо прочитати.

Де виникає. Пакет документації отримується до кешу, спільного для всіх проєктів на машині, з налаштованого реєстру робочого простору в зарезервованому просторі імен docs: сервером для асистентів один раз, під час запуску й до будь-якої відповіді, aggrega explain і поясненням коду в редакторі, коли кожному з них він уперше потрібен, а також aggrega scaffold --example — щоразу лише тоді, коли на машині немає копії, яку допускає перевірка підпису робочого простору. Це перевірка, яку кожне отримання виконує над тим, що повернулося.

Вона ніколи не зупиняє сеанс. Отримання повідомляє свій результат у потоці журналу сервера, і з’єднання триває в будь-якому разі; відхилений артефакт коштує ресурсів документації, які тоді відповідають «не знайдено» протягом цього сеансу. Команді aggrega scaffold --example без пакета нічого записувати, тож там це її відмова, і нічого не записується.

Повідомлення, що виводиться, називає посилання й обидва типи медіа:

docscache: <reference>@<version> has media type "<what was found>", want "<what a documentation bundle is>": docscache: artifact is not a documentation bundle (має тип медіа, очікується інший: артефакт не є пакетом документації)

Як виправити: ваші файли сутностей цього не спричиняють, і жодна зміна в авторингу цього не усуває. Посилання, яке використало отримання, вказує на щось, що не є пакетом документації, — перевірте налаштований реєстр робочого простору, адже посилання на пакет виводиться з нього, а правильно сформоване посилання, що вказує на інший артефакт, розв’язується успішно й дає збій лише тут.

Сторінка відсутня в пакеті документації

Пакет документації було кешовано, а його вміст перевірено, і запитаної сторінки — або, для aggrega scaffold --example, каталогу прикладу — у ньому немає. Це відрізняється від повної відсутності пакета: пакет наявний і цілісний, а запису в ньому бракує.

Вона не доходить до жодного збирання. Поверхня, що надає сторінки документації редактору або асистенту, перетворює її на звичайну відповідь «не знайдено» для запитаного ресурсу. aggrega scaffold --example нічого не записує й повідомляє про неї як про відмову, що називає приклад і пакет, після чого вказує на aggrega scaffold --example --list, яка виводить приклади, що пакет справді містить.

Варто розрізняти, яку з двох відповідей «не знайдено» ви отримуєте, хоча поверхня відображає їх однаково. Ця означає, що пакет кешовано й він цілісний, а сторінки в ньому немає. Інша — немає пакета, який робочий простір може прочитати, бо жоден не кешовано або єдину копію відхиляє перевірка підписів робочого простору, — означає, що отримання не завершилося, а потік журналу сервера пояснює чому.

Повідомлення, що видається, називає сторінку й пакет, у якому її шукали:

page "<page>" in <reference>@<version>: docscache: page not found in documentation bundle (сторінка в: docscache: сторінку не знайдено в пакеті документації)

Як виправити: у ваших файлах нічого не зламано. Сторінка відсутня в пакеті тому, що пакет старіший за неї, або запитаний шлях не той, під яким її опубліковано: пакет отримується у версії, яку сервер повідомляє як власну, тож сторінки, доданої після цієї версії, у ньому немає. Якщо сторінки ніколи не існувало, запит назвав шлях, якого документація не використовує, і правильний шлях слід шукати в опублікованій документації.

Редагування створило б документ, який відхиляє його схема

Відмова під час редагування документа, а не під час збирання. Одне структуроване редагування — додавання компонента, приєднання Feature, з’єднання ребра або встановлення значення — складається й вбудовується в документ, а результат потім перевіряється за схемою для того виду документа, яким він є. Якщо перевірка має заперечення, редагування відхиляється й нічого не записується. Це стосується aggrega edit-document, а також тієї самої можливості, до якої звертається редактор через aggrega serve або асистент; це тонкі точки входу до однієї реалізації.

Вид зчитується з документа і ніколи не передається викликачем. Викликач, що називає вид, міг би назвати неправильний, і тоді результат перевірявся б за схемою, за якою документ не написано, — що пропустило б саме те редагування, яке ця перевірка має відхиляти.

Файл залишається байт у байт таким, яким був, а запис атомарний, тож відхилене редагування неможливо відрізнити від того, якого не пробували, і виправлений запит можна повторити для документа, з якого ви починали.

Її предмет — запит, який був коректно сформований. Запит назвав редагування, яке ця можливість застосовує, а документ, який він створив би, відхилила б схема створення, якби ви ввели його вручну, — тому жодне правило створення тут не повторюється: запит, щоб Release містив значення розробника, відхиляється тією самою схемою в обох випадках. Запит, який так і не адресував редагування — шлях до вузла, що не веде ні до чого в документі, значення, записане як відображення там, де потрібен скаляр, запис, який уже існує з іншим вмістом, — відхиляється на власних підставах, і кожна поверхня повідомляє про це своїм каналом.

Документ, який уже був недійсним, теж про це повідомляє. Перевірка виконується навіть тоді, коли редагування нічого не змінило, тож редагування документа, який продукт відмовився б читати, каже про це, а не повідомляє про успіх.

Ця перевірка та сама, яку застосовує кожне читання документа, тож вона також відхиляє сутність Recipe або FeatureRecipe, конвеєр якої оголошує один ідентифікатор кроку двічі, — правило, яке не може виразити жодна схема; тоді заперечення після речення починається з власного речення і поради цієї умови, як описано в A pipeline declares one step id twice (Конвеєр оголошує один ідентифікатор кроку двічі).

Повідомлення, що видається, після речення містить власне заперечення схеми — вид документа й файл, потім позицію, проблемний ключ і те, що схема там сказала, — і завершується порадою:

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 (редагування відхилено, бо отриманий документ був би недійсним, і нічого не записано: перевірка оболонки документа не вдалася. Виправте документ відповідно до схеми його виду)

Як виправити: відкрийте документ у позиції, яку наводить повідомлення, і прочитайте заперечення, яке каже, чого схема очікувала за цим ключем. Зазвичай змінювати слід запит, а не документ: запитайте запис, який схема допускає в цьому місці, і той самий запит застосується без помилок. Якщо ключ такий, що вид цього документа взагалі не може його містити, йому місце на тій поверхні створення, яка може, а сторінка сутності для цього виду називає поля, які він оголошує. Що є семантично допустимим, на цьому етапі не вирішується — наприклад, чи оголошує виробник певне гніздо залежності, — тож ця відмова завжди стосується форми документа, а не того, що можна споживати через з’єднання.

Ключ анотації використовує префікс, зарезервований платформою

Відмова під час перевірки сутності на відповідність домовленостям публікації, а не під час збирання. Префікс aggrega.ai/, а також feature.aggrega.ai/ поза Feature, належать платформі: ключ, записаний під одним із них, має значення, яке призначає платформа, тож ваша власна сутність, що пише туди, претендує на простір імен, який їй не належить.

Під час створення вона лише радить, а на етапі публікації відхиляє, і обидва прочитання називають цю саму умову. Виявлене однакове в обох випадках; різниться лише наслідок. Так поводиться більшість правил домовленостей публікації, наведених тут, тож це сказано один раз і вважається відомим у записах нижче, які не кажуть іншого, — два правила, що порівнюють з уже опублікованою версією, кажуть про це у власних записах, бо вони взагалі не можуть працювати з локальним вмістом.

Його повідомлення починається так:

an annotation key on the entity uses a prefix the platform reserves (ключ анотації сутності використовує префікс, зарезервований платформою)

Як виправити: перенесіть ключ під префікс, що належить вашій організації. Якщо робочий простір має причину все ж писати під зарезервованим префіксом, це правило — одне з тих, від яких можна відмовитися, як описано в розділі «The discipline rules» у aggrega-lint.md.

Назва сутності не відповідає формі, якої очікує її вид

Відмова під час перевірки сутності на відповідність домовленостям публікації, а не під час збирання. Кожен вид сутності має домовленість щодо форми назви — кількість сегментів для cloud-native видів, PascalCase для бібліотечних видів, — і назва, яку оголошує ця сутність, не відповідає тій, якої очікує її вид.

Його повідомлення починається так:

the entity’s name does not follow the documented name shape for its kind (назва сутності не відповідає задокументованій формі назви для її виду)

Як виправити: перейменуйте сутність відповідно до форми, якої очікує її вид; домовленості для кожного виду наведено в розділі «The discipline rules» у aggrega-lint.md, разом зі способом вимкнення для каталогу, який свідомо називає сутності по-своєму.

Схема використовує динамічне посилання, яке неможливо розв’язати заздалегідь

Відмова під час перевірки сутності на відповідність домовленостям публікації, а не під час збирання. Схема, яку містить сутність, використовує конструкцію динамічного посилання, ціль якої обирається під час валідації документа, а не фіксується під час написання схеми. Тут посилання розгортаються заздалегідь, тож немає валідації, що триває, відносно якої така конструкція могла б розв’язатися.

Його повідомлення починається так:

a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot follow (схема в сутності використовує конструкцію динамічного посилання, якої не може простежити розв’язання посилань між документами)

Як виправити: замініть динамічну конструкцію звичайним посиланням, що прямо називає ціль. Якщо схемі справді потрібна ця конструкція і на неї не посилатимуться з інших документів, правило має спосіб вимкнення, описаний у розділі «The discipline rules» у aggrega-lint.md.

Схема оголошує ідентифікатор, яким володіє платформа

Відмова під час перевірки сутності на відповідність домовленостям публікації, а не під час збирання. Схема, яку містить сутність, оголошує власний ідентифікатор, тоді як канонічний ідентифікатор виводиться з ідентичності сутності. Оголошений ідентифікатор витісняє виведений, тож посилання, написане відносно канонічного ідентифікатора, перестає розв’язуватися.

Його повідомлення починається так:

a schema in the entity declares an identifier of its own, where the platform owns that schema’s identity (схема в сутності оголошує власний ідентифікатор, тоді як ідентичністю цієї схеми володіє платформа)

Як виправити: видаліть оголошений ідентифікатор і дозвольте його вивести. Спосіб вимкнення для схеми, яку свідомо публікують під власним ідентифікатором, описано в розділі «The discipline rules» у aggrega-lint.md.

Мітка категорії сутності Component і її каталог називають різні категорії

Відмова під час перевірки сутності на відповідність домовленостям публікації, а не під час збирання. Сутність Component має мітку категорії й розміщена в каталозі категорії; домовленість полягає в тому, що обидва називають одну категорію, щоб каталог, який переглядає читач, і мітка, з якою збігається селектор, не могли розходитися.

Його повідомлення починається так:

the entity’s category label does not match the category directory the entity is filed under (мітка категорії сутності не збігається з каталогом категорії, у якому розміщено сутність)

Як виправити: змініть те з двох, що є хибним, щоб вони збігалися, — або перемістіть файл у каталог, який називає його мітка, або виправте мітку на категорію, яку називає каталог. Закритий набір категорій і спосіб вимкнення наведено в розділі «The discipline rules» у aggrega-lint.md.

Розширення схеми записано безпосередньо у вміст схеми

Відмова під час перевірки сутності на відповідність домовленостям публікації, а не під час збирання. Сутність Component або Feature записує розширення схеми Aggrega безпосередньо у вміст своєї схеми, хоча сутність має повноцінну поверхню для оголошення того самого. Форма, написана безпосередньо, працює, а домовленість віддає перевагу оголошеній поверхні, бо саме її описують сторінки сутностей і саме її читають інструменти.

Це єдине правило в групі, про яке повідомляє також збирання, як про рекомендацію, що не зупиняє збирання. Перевірка сутності на відповідність домовленостям публікації на етапі публікації підвищує те саме зауваження до відмови.

Його повідомлення починається так:

the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchema (сутність записує розширення схеми Aggrega безпосередньо у вміст схеми замість оголошення)

Як виправити: перенесіть розширення на власну поверхню сокетів або вкладень сутності — саме там його оголошують сторінки сутностей component.md і feature.md. Спосіб вимкнення наведено в розділі «The discipline rules» у aggrega-lint.md.

Сутність Plugin не фіксує жодного обмеження виконання, тож застосовуються обмеження платформи

Рекомендація, що виникає під час перевірки сутності на відповідність домовленостям публікації — як під час написання, так і на етапі публікації; вона нічого не зупиняє, і збирання її не видає. Сутність Plugin оголошує межу пам’яті та обмеження часу, які хост застосовує, коли завантажує й запускає плагін. Плагін, що не оголошує жодного з них, працює зі стандартними значеннями платформи, і це підтримуваний результат, а не помилка, — тож це повідомлення лише вказує, що діють стандартні значення і що їх можна зафіксувати явно.

Його повідомлення починається так:

the Plugin entity declares no runtime resource cap of its own, so the platform defaults apply (сутність Plugin не оголошує власних обмежень ресурсів виконання, тож застосовуються стандартні значення платформи)

Як виправити: зафіксуйте обмеження, які справді потрібні плагіну, або свідомо залиште стандартні значення. Правило не має налаштування вимкнення, бо воно повідомляє факт про сутність, а не оцінку її: тут нічого послаблювати. Поля описано на сторінці plugin.md.

Слот вкладення приймає лише секретні дані, не вказуючи, що обробляє їх

Рекомендація, що виникає під час перевірки сутності на відповідність домовленостям публікації — як під час написання, так і на етапі публікації; вона нічого не зупиняє, і збирання її не видає. Слот вкладення може через свій селектор зафіксувати, що заповнити його може лише сутність Feature із секретами, і може окремо зазначити, що те, що його заповнює, обробляє секретні дані. Селектор визначає, які заповнення допустимі; запис визначає обробку. Слот, який фіксує перше й пропускає друге, залишає обробку виводити із селектора, а не зчитувати зі слота. Перевіряється кожен слот, який оголошує сутність: слот її власного блоку вкладень, а для сутності Component — також слот, який сокет залежності оголошує для кожного з’єднання, прокладеного через нього; зауваження про слот сокета називає сокет поруч зі слотом.

Його повідомлення починається так:

an attachment slot admits only secret material and does not declare that it handles it (слот вкладення приймає лише секретні дані й не оголошує, що обробляє їх)

Як виправити: оголосіть обробку на слоті поруч із селектором, що її фіксує. Правило не має налаштування вимкнення з тієї ж причини, що й правило про обмеження Plugin: воно повідомляє факт про сутність і залишає рішення за вами.

Сутність Recipe публікує ключ provides, якого не оголошує її сутність Component, — перевірка під час публікації

Рекомендація, що виникає під час перевірки сутності на відповідність домовленостям публікації — як під час написання, так і на етапі публікації; вона нічого не зупиняє, і збирання її не видає. Сутність Recipe публікує ключ у provides:, а сутність Component, яку реалізує Recipe, не оголошує цього ключа в стовпі provides своєї схеми. Споживач, що під’єднується через з’єднання, читає оголошений контракт сутності Component, а не те, що видає Recipe, тож ключ створюється, а потім відхиляється там, де щось намагається його спожити.

🔴 Цю ситуацію описують дві умови, і це не одна й та сама. Рекомендацію, яку видає збирання, задокументовано вище в розділі «A Recipe publishes a provides key its Component does not declare»; ця ж виникає під час перевірки сутності на відповідність домовленостям публікації й має власний код. Зауваження — той самий факт, виявлений на двох поверхнях: щоб зрозуміти, з яким ви маєте справу, прочитайте код у діагностиці.

Його повідомлення починається так:

the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refused (сутність Recipe публікує ключ provides, якого не оголошує реалізована нею сутність Component, тож споживачеві, що під’єднує цей ключ, буде відмовлено)

Як виправити: оголосіть ключ у сутності Component, щоб контракт, який читає споживач, містив те, що видає Recipe, — або припиніть публікувати його з Recipe, якщо нічого не має його споживати. Спосіб вимкнення наведено в розділі «The discipline rules» у aggrega-lint.md.

Анотація метрик сутності Component і її ключ provides не узгоджуються

Застереження, що виникає під час перевірки сутності на відповідність домовленостям публікації — і під час створення, і на етапі публікації; воно ніколи нічого не зупиняє, і збірка його не видає. Сутність Component може вказати, як автентифікуються метрики її продукту, в анотації observability.aggrega.ai/metrics-credential — none, target-key або separate-token, — і може оголосити ключ provides metrics_credential_required, який публікує кожна з її сутностей Recipes, щоб повідомити, чи потребують метрики одного екземпляра облікових даних. Це один факт про продукт, побачений з двох боків, тому сутність Component, яка вказує, що її метрики не потребують облікових даних, не оголошує такого ключа, а та, що вказує, що потребують, — оголошує його. Ця умова повідомляє про сутність Component, у якій ці два елементи не узгоджуються, і називає сутність Component, значення анотації та зайвий або відсутній ключ.

Його повідомлення починається так:

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 (анотація сутності Component, що вказує, як автентифікуються її метрики, не узгоджується з тим, чи оголошує вона ключ provides, який повідомляє, що метрики екземпляра потребують облікових даних)

Як виправити: виправте той із двох елементів, який хибний: оголосіть metrics_credential_required в опорі provides і публікуйте його з кожної сутності Recipe, якщо метрики потребують облікових даних; видаліть його, якщо не потребують; або змініть анотацію на значення, що описує продукт. Ця перевірка не має параметра вимкнення з тієї ж причини, з якої його не має правило про обмеження сутності Plugin; які значення вона читає і які сутності Components залишає непрочитаними, описано в розділі «The discipline rules» у aggrega-lint.md.

З’єднання і ціль, до якої воно веде, не називають один ключ

Застереження, що виникає під час перевірки сутності Release на відповідність домовленостям публікації; воно ніколи нічого не зупиняє, і збірка його не видає. Сервер, що перевіряє ключ, зберігає ключ, який він верифікує, у власному слоті, а клієнт пред’являє ключ на з’єднанні, через яке він звертається до цього сервера. Жоден бік не бачить ключа іншого, тож це один ключ лише тому, що їхні автори записують однаковий локатор на обох кінцях. Ця умова повідомляє про з’єднання, ціль якого оголошує слот для ключа, що вона вимагає від клієнтів, коли ключі не збігаються: з’єднання несе облікові дані, а слот ключа цілі не заповнено; слот ключа цілі заповнено, а з’єднання не несе облікових даних; або обидва заповнено, але локатори записано по-різному.

На відміну від правил вище, це правило читає всю сутність Release, а не одну сутність, тому воно виникає лише під час перевірки сутності Release і ніколи на етапі публікації, який перевіряє одну сутність окремо; де б про нього не повідомлялося, це порада. Знахідка називає компонент, з’єднання, ціль і обидва слоти й ніколи не цитує жодного локатора. Збір метрик — з’єднання на сокеті scrape_target — оцінюється за тим, що ціль вказує про свої метрики: зовсім не оцінюється, якщо анотація цілі observability.aggrega.ai/metrics-credential має значення none, ніколи не порівнюється з ключем цілі, якщо вона має значення separate-token, а в інших випадках — як будь-яке інше з’єднання; з’єднання на будь-якому іншому сокеті оцінюється незалежно від того, що вказує ціль.

Його повідомлення починається так:

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 (з’єднання і ціль, до якої воно веде, не називають один ключ: вони записують для нього різні локатори або ключ називає лише одне з них)

Як виправити: зробіть так, щоб обидва кінці читали один параметр — credential з’єднання і api_key цілі, — тоді ключ, який пред’являє клієнт, і ключ, який верифікує сервер, не можна буде записати по-різному; або, якщо з’єднання не має пред’являти ключа, приберіть із нього облікові дані. Які слоти читаються, що порівнюється і як вимкнути перевірку, описано в розділі «The discipline rules» у aggrega-lint.md.

Зміна, що публікується, порушує те, що дозволяє рубрика еволюції

Відмова під час перевірки, що передує публікації, а не під час збірки. Версія, що публікується, порівнюється з версією, опублікованою перед нею, і різниця між ними класифікується за документованою рубрикою. Ця умова повідомляє, що різниця є такою, проти якої рубрика заперечує.

Їй потрібна опублікована попередня версія для порівняння, тому це правило й описана нижче перевірка підвищення версії — два правила в цій групі, які не можуть працювати лише з локальним вмістом: якщо реєстр не запитується, порівнювати нічого, і перевірка пропускається, а не вважається пройденою.

Його повідомлення починається так:

the version being published changes the published predecessor in a way the documented evolution rubric objects to (версія, що публікується, змінює опубліковану попередню версію у спосіб, проти якого заперечує документована рубрика еволюції)

Як виправити: прочитайте класифікацію в діагностиці, яка називає, проти чого в зміні заперечила рубрика, і або зробіть зміну сумісною, або опублікуйте її під версією, яка її допускає. Рубрику викладено в розділі «The version-bump rubric» у aggrega-lint.md.

Запропонована версія — менше підвищення, ніж вимагає зміна

Відмова під час перевірки, що передує публікації, а не під час збірки. Зміна, що публікується, класифікується за рубрикою еволюції, а запропонована для неї версія — менший крок, ніж вимагає ця класифікація, наприклад вилучення чи звуження, запропоноване як патч. Надмірне підвищення версії завжди приймається; зупиняє тут саме недостатнє.

На відміну від правил вище, це правило вирішується тут, а не плагіном домовленостей. Яке підвищення запропоновано, відомо лише в момент публікації, а компіляція тоді не виконується, тому порівняння класифікації із запропонованою версією робиться саме тоді.

Його повідомлення починається так:

the version bump being published is smaller than the evolution check’s classification of the change requires (підвищення версії, що публікується, менше, ніж вимагає класифікація зміни перевіркою еволюції)

Як виправити: опублікуйте під версією, якої вимагає класифікація; діагностика називає, яка це версія. Якщо ви вважаєте, що зміна менша, ніж її класифіковано, рубрика в розділі «The version-bump rubric» у aggrega-lint.md пояснює, що відносить зміну до кожного класу. Перша публікація сутності не має попередньої версії, тому порівняння пропускається і позначається як не виконане, а не як пройдене.

Імпорт зупинився на півдорозі перекладу джерела

Відмова під час перетворення стороннього опису джерела на чернеткові файли авторингу, а не під час збірки. Імпортер повідомив діагностику, достатньо серйозну, щоб зупинити переклад, тому створене ним часткове: частина джерела стала чернетковими файлами авторингу, а частина — ні.

Частковий результат навмисний, а не уламки. Умова називає наслідок, а не причину: те, що не вдалося перекласти, повідомляється в діагностиках поруч, по одній на кожну конструкцію, яку імпортер не зміг перенести, власними словами імпортера. Ця умова дає змогу викликачу відрізнити «імпорт зупинився і дав частину відповіді» від «імпорт повністю не вдався» — це різні ситуації з різними подальшими кроками.

Його повідомлення починається так:

the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring files (імпортер повідомив діагностику, що зупиняє імпорт, тому джерело не було повністю перетворено на чернеткові файли авторингу)

Як виправити: прочитайте діагностики, повідомлені поруч, — кожна називає конструкцію в джерелі, яку імпортер не зміг перекласти. Виправлення полягає в джерелі, яке ви передали, або в доопрацюванні чернетки вручну: імпорт створює відправну точку для редагування, тож конструкцію, що не пережила перекладу, слід написати безпосередньо на боці Aggrega. aggrega-import.md описує, що створює команда і куди вона записує.

More than one importer recognises the source (Джерело розпізнає більше ніж один імпортер)

Відмова під час перетворення стороннього опису джерела на чернеткові файли авторингу, а не під час збірки. Імпорт не вказав формату, тож формат розпізнавався за сигнатурами, які оголошують імпортери — як ті, що є в каталозі робочого простору, так і базові імпортери компілятора, кожна з яких називає синтаксис, у якому читається джерело, імена файлів, до яких вона застосовується, і шляхи, які розібране дерево повинно або не повинно містити, — і з джерелом збіглися сигнатури імпортерів, що обслуговують більше ніж один формат. Імпорт не обирає між ними: у якому форматі джерело — це твердження імпортерів, а не компілятора, і вибір був би здогадом, що передає джерело імпортеру, для якого воно може й не призначатися.

Це не те саме, що один формат, який оголошують кілька імпортерів, описаний вище в розділі «A parse or import format is advertised by more than one plugin». Там формат визначено, і конкурують імпортери, що його обслуговують, тож вибір між ними робить запис plugins.importer; тут різняться самі формати, тож жодне підключення цього не вирішує, а вирішує вказання формату. Імпортер, що розпізнає джерело, розпізнає його як кожен формат, який він оголошує, тож імпортер, що оголошує більше ніж один формат і одна із сигнатур якого збігається, тут теж отримує відмову.

Його повідомлення починається так:

more than one importer recognises the source (джерело розпізнає більше ніж один імпортер)

Решта повідомлення називає джерело та кожен формат, як який його розпізнано, у порядку ідентичностей і версій імпортерів, а потім спосіб виправлення:

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>) (джерело розпізнає більше ніж один імпортер (джерело, розпізнано як …). Передайте —format, щоб назвати формат, у якому його читати (наприклад, —format … або —format …))

Як виправити: вкажіть формат — --format у aggrega import або format в інструменті імпорту асистента та в методі сесії aggrega/import. Якщо один з імпортерів ніколи не повинен розпізнавати таке джерело, змінювати слід сигнатури цього імпортера, які його автор оголошує у самозвіті describe() і які записує його сутність Plugin під час генерування; або, якщо він є в каталозі робочого простору, вилучіть його з каталогу, який читає робочий простір, — базовий імпортер завжди є серед випробовуваних, тож джерело, яке один із них розпізнає разом з іншим імпортером, вирішується вказанням формату. aggrega-import.md описує, як розпізнається формат.

No importer recognises the source (Жоден імпортер не розпізнає джерело)

Відмова під час перетворення стороннього опису джерела на чернеткові файли авторингу, а не під час збірки. Імпорт не вказав формату, тож формат розпізнавався за сигнатурами, які оголошують імпортери — як ті, що є в каталозі робочого простору, так і базові імпортери компілятора, — і з джерелом не збіглися сигнатури жодного формату. Імпорт не вгадує: передати джерело імпортеру, який ніколи не оголошував, що читає таку форму, означало б створити чернетку з джерела, для якого він може й не призначатися.

Це відповідник умови «More than one importer recognises the source» вище. Там на джерело претендують кілька форматів; тут — жоден. В обох випадках це вирішує вказання формату, і нічого не записується, доки його не вказано.

Його повідомлення починається так:

no importer recognises the source (жоден імпортер не розпізнає джерело)

Решта повідомлення називає джерело, потім спосіб виправлення та кожен формат, який оголошують імпортери каталогу, у порядку, в якому їх прочитано:

no importer recognises the source (source "<source>"). Pass —format to name it explicitly (for example —format <format> or —format <format>) (жоден імпортер не розпізнає джерело (джерело). Передайте —format, щоб явно вказати формат (наприклад, —format … або —format …))

Якщо жоден імпортер не оголошує жодного формату, спосіб виправлення повідомляє про це замість прикладів.

Директорії пропонується інший спосіб виправлення, бо зазначення будь-якого формату не може їй допомогти. Директорія читається лише через шаблони файлів, які оголошує її імпортер, а сигнатура, що не оголошує жодного шаблону файлів, не застосовується до жодного з файлів директорії — тож директорію, що містить, скажімо, один експорт Langflow, не розпізнає жодна сигнатура, а зазначення формату langflow своєю чергою було б відхилено згідно з An importer that declares no file patterns is handed a directory (Імпортер, що не оголошує шаблонів файлів, отримує директорію). Тому відмова для директорії називає її директорією й пропонує імпортувати окремо один з її файлів або зазначити формат, імпортер якого оголошує шаблони файлів, — лише ці формати, зчитані з власних оголошень імпортерів:

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>) (жоден імпортер не розпізнає джерело (директорія). Імпортуйте окремо один із файлів директорії або передайте —format із форматом, імпортер якого читає директорію через оголошені ним шаблони файлів (наприклад, —format або —format))

Якщо жоден імпортер не оголошує шаблону файлів, відмова пропонує імпортувати окремо один із файлів директорії й повідомляє, що жоден імпортер у каталозі не оголошує шаблонів файлів, через які читається директорія.

Як виправити: вкажіть формат — --format у aggrega import або format в інструменті імпорту асистента та в методі сесії aggrega/import, кожен з яких формулює відмову відповідно до поля, яке він приймає, і починає її коротким кодом цієї умови; відповідь сесії також містить у своїх даних обидва коди умови. Для директорії імпортуйте окремо той один файл, який ви мали на увазі, — сигнатура, що не називає жодного файлу, застосовується до файлу, імпортованого окремо, хоч би як він називався, — або вкажіть один із форматів, які перелічує відмова. Якщо джерело мало бути розпізнане, змінювати слід сигнатури імпортера, що обслуговує його формат, які його автор оголошує у самозвіті describe() і які записує його сутність Plugin під час генерування. aggrega-import.md описує, як розпізнається формат.

An importer that declares no file patterns is handed a directory (Імпортеру, що не оголошує шаблонів файлів, передано каталог)

Відмова під час перетворення стороннього опису джерела на чернеткові файли авторингу, а не під час збірки. Указане джерело — каталог, а каталог передається імпортеру саме як ті файли, які вибирають оголошені шаблони файлів імпортера, — тож які файли каталогу читає імпортер, визначає власне твердження імпортера. Імпортер, що обслуговує формат джерела, не оголошує шаблонів файлів: він читає один файл і нічого не каже про те, які файли каталогу є його.

Нічого не відкривається. Імпорт зупиняється, щойно імпортера визначено, і до того, як прочитано будь-який файл каталогу, замість того щоб передати імпортеру всі файли каталогу.

Його повідомлення починається так:

the importer serving the source’s format declares no file patterns, so it reads one file and cannot read a directory (імпортер, що обслуговує формат джерела, не оголошує шаблонів файлів, тож він читає один файл і не може читати каталог)

Решта повідомлення називає формат, імпортер і каталог так, як ви його вказали, а потім спосіб виправлення:

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 (імпортер, що обслуговує формат джерела, не оголошує шаблонів файлів, тож він читає один файл і не може читати каталог (формат, імпортер, каталог). Натомість імпортуйте окремо один із файлів каталогу; імпортер читає каталог, щойно оголосить шаблони, за якими називаються його файли)

Як виправити: імпортуйте окремо один файл цього формату. Щоб імпортер читав каталоги свого формату, його автор оголошує шаблони, за якими називаються його файли, — files сигнатури розпізнавання в самозвіті describe(), які записує його сутність Plugin під час генерування. aggrega-import.md описує, що читає імпорт каталогу.

No file in the directory matches the importer’s file patterns (Жоден файл у каталозі не відповідає шаблонам файлів імпортера)

Відмова під час перетворення стороннього опису джерела на чернеткові файли авторингу, а не під час збірки. Указане джерело — каталог, формат визначено, і імпортер, що його обслуговує, оголошує шаблони файлів, — але жоден файл у каталозі, на будь-якій глибині, не відповідає жодному з них. Якби імпортеру не передали жодного джерела, він завершився б помилкою на порожньому, у формулюваннях про вміст, а не про те, які файли прочитано, тож імпорт зупиняється тут, нічого не прочитавши.

Якщо формат розпізнано, а не вказано, імпортер, чия сигнатура розпізнала каталог, зіставився з одним із його файлів, тож ця умова виникає лише тоді, коли запущений імпортер — не той: інший імпортер того самого формату, якого вибирає запис plugins.importer, або інша його версія.

Його повідомлення починається так:

no file in the directory matches the file patterns the importer serving the source’s format declares (жоден файл у каталозі не відповідає шаблонам файлів, які оголошує імпортер, що обслуговує формат джерела)

Решта повідомлення називає формат, імпортер, каталог так, як ви його вказали, і кожен шаблон, який оголошує імпортер, а потім спосіб виправлення:

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 (жоден файл у каталозі не відповідає шаблонам файлів, які оголошує імпортер, що обслуговує формат джерела (формат, імпортер, каталог, шаблони файлів). Вкажіть каталог, що містить файл, який відповідає одному з цих шаблонів, або формат імпортера, чиї шаблони відповідають файлам цього каталогу)

Як виправити: імпортуйте каталог, що містить файли цього формату, — шаблон зіставляється із закінченням шляху файлу всередині каталогу, тож враховується файл на будь-якій глибині, — або вкажіть формат, у якому є файли каталогу. aggrega-import.md описує, що читає імпорт каталогу.

A file read from the directory and a file named in the importer’s with.sources have the same name (Файл, прочитаний із каталогу, і файл, названий у with.sources імпортера, мають однакову назву)

Відмова під час перетворення стороннього опису джерела на чернеткові авторські файли, а не під час збірки. Назване джерело є каталогом, і його файли надходять до імпортера як іменовані джерела, кожне під своїм шляхом усередині каталогу. Запис plugins.importer, що під’єднує імпортер, називає власні файли в with.sources, які теж надходять до нього як іменовані джерела, кожне під своєю базовою назвою, — і одну назву мають обидва. Саме за назвою імпортер відрізняє одне джерело від іншого, тож передати йому обидва означало б, що одне з них затінює інше, і ніщо не вказує, яке саме; натомість імпорт зупиняється, нічого не передавши.

Його повідомлення починається так:

a file read from the directory and a file named in the importer’s with.sources have the same name

Решта повідомлення називає назву і файл із with.sources, а потім спосіб виправлення:

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

Як виправити: перейменуйте один із двох файлів або вилучіть файл із with.sources запису, якщо каталог уже містить його. Файл із with.sources зберігає свою базову назву, тож він стикається з файлом тієї самої назви у верхньому рівні каталогу; файл у вкладеному каталозі містить цей каталог у своїй назві. Який імпортер перетворює джерело на чернетки описує with.sources запису.

An import’s target names a capability no Recipe in the catalog binds to (Ціль імпорту називає можливість, до якої не прив’язується жоден Recipe у каталозі)

Відмова під час перетворення стороннього опису джерела на чернеткові авторські файли, а не під час збірки. Імпорту було задано ціль — --target в aggrega import або target в інструменті імпорту асистента та методі aggrega/import сеансу, — щоб він створив чернетку Manifest, яка зіставляє кожен створений тип компонента з Recipe цього провайдера. Ціль — це можливість провайдера, яку порівнюють із spec.capability, до якої прив’язується кожен Recipe у каталозі робочого простору, і жоден Recipe там не прив’язується до заданої. Створений для неї Manifest не зіставляв би нічого, і тоді кожен тип компонента виглядав би відсутнім у каталозі, хоча помилковою є сама опція — найчастіше через описку.

Нічого не виконується і нічого не записується. Імпорт зупиняється після завантаження каталогу, до розпізнавання формату джерела і до запуску імпортера, тож жодної чернетки не створено і жодного файлу не записано, зокрема й під час пробного запуску.

Його повідомлення починається так:

no Recipe in the workspace’s catalog binds to the capability the import’s target names

Решта повідомлення називає ціль точно так, як її задано, і можливості, до яких таки прив’язуються Recipes каталогу, кожну один раз і в сортованому порядку, а потім спосіб виправлення:

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

Якщо каталог не містить жодного Recipe, повідомлення зазначає це замість списку, а спосіб виправлення — додати до каталогу Recipe цього провайдера.

Як виправити: назвіть одну з можливостей, наведених у повідомленні, — наприклад, compose або helm, як її записує spec.capability у Recipe, — або не задавайте ціль, і тоді чернетку Manifest не буде створено. Якщо провайдер, який ви мали на увазі, ще не має жодного Recipe у каталозі, додайте його Recipes до теки каталогу, яку робочий простір читає, перш ніж імпортувати. aggrega-import.md описує, що створює імпорт із заданою ціллю.

Дочірній Release успадковує каталог межі, що розв’язується туди, куди записує батьківський

Попередження. Release розширює інший і успадковує від нього вихідний каталог межі, а цей каталог не містить жодної змінної шаблону, — тож для обох він розв’язується в той самий шлях, і збирання дочірнього записує туди ж, куди й збирання батьківського.

Успадкування каталогу — підтримувана форма, а не помилка. Каталог є шаблоном, тож батьківський записує його один раз, а дочірній, що заповнює параметр, розв’язує його деінде без жодного дублювання; саме тому дочірньому не потрібно повторювати топологію меж батьківського. Вузьким і реальним є лише залишковий випадок, який тут названо: без змінної в ньому нічого не можна розв’язати інакше.

Воно не може зупинити збірку, і це властивість правила, а не обережність щодо нього. Запис за тим самим розв’язаним шляхом може бути цілком законним наміром автора — дочірній, що замінює лише Recipes рендерингу, щоб порівняти їхній результат, або змінює лише розміри, — тож правило, що зупиняло б збірку на підставі здогаду, відхиляло б коректні вхідні дані навмання.

Його повідомлення починається так:

inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to

Як виправити: якщо обидва мали записувати в різні місця, додайте до каталогу посилання на параметр і дайте кожному Release заповнити його. Якщо ви саме й мали на увазі запис за одним шляхом, нічого змінювати не потрібно — попередження повідомило, що станеться, і збірка в будь-якому разі створює свій результат.

Пошук зупинки за коротким кодом, який вивела збірка

Заголовок у квадратних дужках діагностики, що зупиняє збірку, називає категорію, до якої належить збій, і, якщо збій називає одну з описаних тут умов, — короткий код цієї умови: літеру E і чотири цифри, як у [CATALOG_ERROR E0209]. Номер призначається один раз і потім не змінюється, тож короткий код, який ви вставите у звіт чи пошук, і далі називатиме ту умову, яку називав, коли ви його записали. Два інші ідентифікатори умови, а також те, до якого з трьох і коли звертатися, описано в sentinels.md.

Власний рядок повідомлення умови починається з фіксованого речення, що формулює умову. Усе після цього речення залежить від конкретного випадку — документ із помилкою, написаний ключ, хибне значення і порада для цього випадку, — а записи вище наводять повну форму для умови, яку документує кожен із них. Фіксоване речення — це частина, однакова щоразу, і саме тому за нею слід шукати збіг.

Таблиця нижче зіставляє одне з одним у межах цієї сторінки: для кожної описаної тут умови — короткий код, який виводить збірка, і речення, з якого починається рядок її повідомлення, навпроти запису вище, що пояснює виправлення. Заголовки записів наведено дослівно, тож пошук одного з них на цій сторінці приведе до його запису. Таблиця всіх умов розшифровує короткий код для кожної умови, яку оголошує компілятор, зокрема тих, яких не охоплює жоден запис тут.

Якщо один запис стоїть навпроти двох коротких кодів, він охоплює дві різні умови, і кожна реєструє власне речення; щоб визначити, про яку з них повідомила збірка, читайте речення, а не спільний заголовок.

aggrega explain <code> виконує цей пошук за вас у терміналі: команда приймає будь-який із кодів умови й виводить умову разом із записом вище, що її документує. Її описано в aggrega explain.

Короткий кодПочинається зОписано в
E0001cliplugin: no plugin resolver configuredЗасіб запуску плагінів командного рядка зібрано без способу знаходити плагіни
E0003malformed attachment requirementMalformed attachment requirement (Некоректна вимога до приєднання)
E0004annotation contribution overridden by an explicit valueЯвне значення витіснило значення, надане анотацією
E0005policy violationA governance plugin rejected the build (Плагін управління відхилив збірку)
E0006required attachment slot unfilledRequired attachment slot not bound (Обов’язковий слот підключення не заповнено)
E0007selector violationCross-node type safety violation via selector: (Порушення безпеки типів між вузлами через selector:)
E0008attachment slot selector unsatisfiedThe Feature filling an attachment slot does not satisfy the slot’s selector (Feature, що заповнює слот приєднання, не задовольняє селектор слота)
E0009pipeline step typed-I/O contract violationA pipeline step’s typed input or output does not satisfy its declared contract (Типізований вхід або вихід кроку конвеєра не відповідає оголошеному контракту)
E0010pipeline step failedA pipeline step failed (Крок конвеєра завершився помилкою)
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 (Патч конвеєра адресує документ, якого немає в наборі, або документ без дерева для адресування)
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 (Патч конвеєра адресує документ, якого немає в наборі, або документ без дерева для адресування)
E0013feature type mismatch between Aggregate and ReleaseFeature type mismatch between Aggregate and Release (невідповідність типу Feature між Aggregate і Release)
E0014inject entry carries both `value:` and `from:`; schema requires exactly oneAn inject: entry carries both a literal and a source key (запис inject містить і літерал, і ключ джерела)
E0015uses-edge inject dictates a delivery mechanism the socket does not permituses edge dictates delivery on a socket that allowlists none (Ребро uses задає доставку на сокеті, який не дозволяє жодної); uses edge dictates a delivery mechanism outside the socket’s allowlist (Ребро uses задає механізм доставки поза списком дозволених сокета)
E0016jsonpatch: test operation failedA patch’s test operation did not match the document (Перевірна операція патча не збіглася з документом)
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 (Плагін перетворення анотацій називає компонент, якого йому не передали, або впроваджує значення, якого не приймає жодна анотація)
E0018policy attachment settings do not satisfy the plugin's declared settings schemaA governance attachment’s settings do not match the plugin’s declared schema (Налаштування під’єднання управління не відповідають оголошеній схемі плагіна)
E0019endpoint requires form: referenceA workload: form and the fields beside it do not agree (Форма робочого навантаження і поля поруч із нею не узгоджуються)
E0020schedule is not a valid cron expressionA workload schedule: is not an expression the check accepts (Розклад робочого навантаження не є виразом, який приймає перевірка)
E0021persistentTemplate volume requires form: statefulA workload: form and the fields beside it do not agree (Форма робочого навантаження і поля поруч із нею не узгоджуються)
E0022pipeline PATCH target is not parseable structured YAML/JSONA pipeline step addresses documents the node does not have (Крок конвеєра адресує документи, яких вузол не має)
E0023form: reference requires an endpointA workload: form and the fields beside it do not agree (Форма робочого навантаження і поля поруч із нею не узгоджуються)
E0024schedule requires form: scheduledA workload: form and the fields beside it do not agree (Форма робочого навантаження і поля поруч із нею не узгоджуються)
E0025form: scheduled requires a scheduleA workload: form and the fields beside it do not agree (Форма робочого навантаження і поля поруч із нею не узгоджуються)
E0026imported artifact content does not match the digest recorded for it in entity.lockІмпортований артефакт більше не відповідає дайджесту, записаному поряд із його Recipe
E0027artifacts $import: is not a bare-name artifact-library reference (<Library>#/artifacts/<entry>)Бібліотечний $import: записано не у формі простого імені
E0028artifacts output filename collision: two artifact outputs carry the same filenameДва артефактні виходи одного Recipe мають однакову назву файлу
E0029artifact template references a pillar the Recipe does not declareAn artifacts: template reads a pillar the Recipe does not declare (Шаблон artifacts: читає опору, яку Recipe не оголошує)
E0030artifact-library import references a bundle not present in the ArtifactLibraryБібліотечний $import: називає бібліотеку або запис, яких немає в каталозі
E0031artifact-library import references an ArtifactLibrary not present in the catalogБібліотечний $import: називає бібліотеку або запис, яких немає в каталозі
E0032assembled output collision: two contributors write the same output pathTwo contributors write the same output path (Два учасники записують за одним вихідним шляхом)
E0033assertion failedAn assertion stopped the build (Твердження зупинило збирання)
E0034duplicate delivery key across attachment-inject and another inject sourceAn attachment delivers a key another inject source already claimed (Прикріплення доставляє ключ, який уже заявило інше джерело inject)
E0035provider expected to assemble its dispatch group provides no boundary assemblerThe plugin serving a provider cannot assemble what that provider combines (Плагін, що обслуговує провайдер, не може зібрати те, що цей провайдер об’єднує)
E0036merged-path assembly has conflicting assembly-name annotation valuesChart-name mismatch on a merged helm-chart umbrella (Невідповідність назви чарту в об’єднаному парасольковому чарті helm-chart)
E0037cross-boundary link between endpoints rendered by different providers is not supportedЗ’єднання перетинає межу між зібраними виходами двох різних провайдерів
E0038derived name collision: one name is derived more than once in one key spaceThe same name is derived more than once inside the output (Одна й та сама назва виводиться у виводі більше одного разу)
E0039FeatureRecipe template references a per-component-only field with executionScope: boundaryFeatureRecipe template references a field outside its scope’s allowlist (Шаблон FeatureRecipe посилається на поле поза дозволеним списком своєї області)
E0040library $import: carries a registry host; reference the library by bare-name identityБібліотечний $import: адресує свою бібліотеку за розташуванням у реєстрі
E0041multiple contributors share an instance ID at the same dispatch pathInstance-ID collision across boundaries assembling to the same path (Колізія ідентифікаторів екземплярів між межами, що збираються за одним шляхом)
E0042locals entry references a sibling defined later in the same blockЗапис locals: посилається на сусідній запис, визначений пізніше в тому самому блоці
E0043template references a key the locals block does not declareКлюч locals: не існує
E0044mapping-library import references an entry not present in the MappingLibraryБібліотечний $import: називає бібліотеку або запис, яких немає в каталозі
E0045valuesMapping $import: is not a bare-name mapping-library reference (<Library>#/mappings/<entry>)Бібліотечний $import: записано не у формі простого імені
E0046mapping-library import references a MappingLibrary not present in the catalogБібліотечний $import: називає бібліотеку або запис, яких немає в каталозі
E0047assembled output retains an unresolved cross-boundary link placeholderAssembled output still carries a cross-boundary placeholder (Зібраний результат досі містить заповнювач для зв’язку між межами)
E0048dispatch path produced multiple provider outputsPath collision: two contributors emit at incompatible paths (Колізія шляхів: два учасники виводять за несумісними шляхами)
E0049path template references a field not in the documented allowlistPath-template references a variable outside the allowlist (Шаблон шляху посилається на змінну поза списком дозволених)
E0050pipeline /host operation from a step with no host componentA pipeline step addresses documents the node does not have (Крок конвеєра адресує документи, яких вузол не має)
E0051pipeline PATCH targets an assembler provider's pre-assembly fragmentsA pipeline patch addresses output that has not been assembled yet (Патч конвеєра адресує вивід, який ще не зібрано)
E0052pipeline PATCH targets a document the node did not emitA pipeline step addresses documents the node does not have (Крок конвеєра адресує документи, яких вузол не має)
E0053pipeline plugin is not compatible with the rendering providerA pipeline step’s plugin does not claim the provider rendering what it addresses (Плагін кроку конвеєра не заявляє провайдер, що рендерить адресоване)
E0054provider rejected node inputA provider refused a node’s input (Провайдер відхилив вхідні дані вузла)
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 або FeatureRecipe не публікує ключ, який оголошує її контракт)
E0056provides template evaluation failedA provides: template could not be evaluated (Не вдалося обчислити шаблон provides)
E0057provides block references a root outside the self-contained setШаблон provides: посилається на несамодостатній корінь
E0058provider render is not deterministicA provider rendered the same input twice and produced different output (Провайдер двічі відрендерив ті самі вхідні дані й отримав різний результат)
E0059duplicate delivery key across self-inject and uses-injectDuplicate delivery key across inject sources (Дублікат ключа доставки серед джерел inject)
E0060template references a root the render context does not defineTemplate references a root the render context does not define (Шаблон посилається на корінь, який контекст рендерингу не визначає); Self-inject value template references cross-node data (Шаблон значення self-inject посилається на дані інших вузлів)
E0061unknown providerUnknown provider (Невідомий провайдер)
E0062custom inject mechanism has no matching key in injectMapping output; add the mechanism's key to the Recipe injectMappingКомпонент оголошує механізм inject, на який приєднана Feature нічого не відображає
E0063workload-library import references an entry not present in the WorkloadLibraryБібліотечний $import: називає бібліотеку або запис, яких немає в каталозі
E0064workload $import: is not a bare-name workload-library reference (<Library>#/workloads/<entry>)Бібліотечний $import: записано не у формі простого імені
E0065workload-library import references a WorkloadLibrary not present in the catalogБібліотечний $import: називає бібліотеку або запис, яких немає в каталозі
E0066uses edge target does not existЗавислa ціль uses
E0067active toggle did not resolve to a booleanПеремикач active: не розв’язується в true або false
E0068max sub-aggregate nesting depth exceededПеревищено глибину вкладення субагрегатів
E0069mutator patch rejectedПатч плагіна з роллю label-transform виходить за межі міток вузлів
E0070re-exported component alias forms a cycleПовторно опублікований псевдонім компонента вказує сам на себе
E0071release edge retargets a developer-declared edgeRelease retargets a developer-declared edge (Release перенаправляє ребро, оголошене розробником)
E0072sub-aggregate load failedМодуль, який імпортує композиція, не вдається завантажити, або він імпортує сам себе
E0073flattened node ID collision: rename one of the colliding instances so their flattened IDs differДва екземпляри сплощуються в один ідентифікатор
E0074release per-edge configuration has no edge to apply toRelease per-edge configuration has no edge to apply to (Конфігурації ребра в Release ні до якого ребра застосовуватися)
E0075aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem)An Aggregate reached graph building without being normalised (Сутність Aggregate дійшла до побудови графа без нормалізації)
E0076sub-module placed in no boundary: route it into a boundary under `aggregates`, or name its components there under `components`Компоненти підмодуля не розміщено в жодній межі
E0077uses edge target was pruned because its active toggle resolved to falseРебро uses указує на компонент, вилучений перемикачем 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 (Плагін просить хост розібрати джерело, коли для нього вже виконується розбір)
E0079wasm: recorded command mirror does not match plugin describe()A Plugin entity’s recorded command set does not match the plugin (Записаний набір команд сутності Plugin не збігається з плагіном)
E0080wasm: entity contract claim does not match plugin describe()A Plugin entity’s claims disagree with the plugin’s own self-report (Твердження сутності Plugin не збігаються з власним звітом плагіна)
E0081wasm: guest plugin returned a diagnostic whose severity the contract does not declareA plugin returned a diagnostic at a severity that is not declared (Плагін повернув діагностику з неоголошеним рівнем серйозності)
E0082wasm: guest plugin reported an errorПлагін зазнав збою під час виконання
E0083wasm: guest plugin panicked during callПлагін зазнав збою під час виконання
E0084wasm: stamped host-function record does not match .wasm importsA Plugin entity’s recorded host functions do not match the binary (Записані функції хоста сутності Plugin не збігаються з бінарним файлом)
E0085wasm: plugin rejected by the sandboxПісочниця відхилила плагін
E0086wasm: plugin invoked proc_exitПлагін зазнав збою під час виконання
E0087wasm: declared plugin type does not match plugin describe()Плагін не того виду, на який очікує сокет
E0088wasm: entity metadata.version does not match plugin describe()A Plugin entity’s recorded version does not match the plugin (Записана версія сутності Plugin не збігається з плагіном)
E0089every published version this reference could select has been withdrawnEvery version a reference could select has been withdrawn (Усі версії, які могло б вибрати посилання, відкликано)
E0090format is advertised by more than one importer pluginA parse or import format is advertised by more than one plugin (Формат розбору чи імпорту оголошує більше ніж один плагін)
E0091format is advertised by more than one parser pluginA parse or import format is advertised by more than one 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 (Можливість обслуговує більше ніж один плагін провайдера)
E0093manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguousA Manifest maps two version-distinct keys onto one type (Manifest зіставляє з одним типом два ключі, що відрізняються версією)
E0094duplicate entity identity within a single catalog directoryДві сутності каталогу в одному каталозі мають однакову ідентичність
E0095malformed recipe reference in a Manifest mapping valueManifest mapping value is not a shape a recipe reference accepts (Значення зіставлення в Manifest має форму, якої не допускає посилання на рецепт)
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 (implements у Recipe не відповідає зіставленому типу компонента)
E0097no importer plugin advertises the requested formatNo plugin advertises a requested parse or import format (Жоден плагін не оголошує запитаний формат розбору чи імпорту)
E0098no parser plugin advertises the requested formatNo plugin advertises a requested parse or import format (Жоден плагін не оголошує запитаний формат розбору чи імпорту)
E0099no recipe resolved for component/feature instance: add an explicit Manifest mapping for its typeNo Recipe is mapped for a component or feature instance (Для екземпляра компонента чи функції не зіставлено жодного Recipe)
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 (Прив’язка plugins.providers називає плагін, який не обслуговує цю можливість)
E0101no provider-rendering plugin version satisfies the recipe's provider version pinNo provider plugin version satisfies a Recipe’s provider pin (Жодна версія плагіна провайдера не задовольняє закріплення провайдера в сутності Recipe)
E0102wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact pathA plugin reference carries a registry host or an artifact path (Посилання на плагін містить хост реєстру або шлях до артефакту)
E0103no catalog version satisfies the referenced version constraintNo catalog version satisfies a version constraint (Жодна версія в каталозі не задовольняє обмеження версії)
E0104wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI locationA plugin or recipe reference carries no scope (Посилання на плагін або рецепт не містить області)
E0105recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI locationA plugin or recipe reference carries no scope (Посилання на плагін або рецепт не містить області)
E0106resolve: invalid library reference URIA library reference is not written in the identity form (Посилання на бібліотеку записано не у формі ідентичності)
E0107resolve: minimal version selection conflict — incompatible library version requirementsTwo consumers of one library require incompatible versions (Два споживачі однієї бібліотеки вимагають несумісних версій)
E0108resolve: catalog lookup cannot load resolved sub-aggregate bodiesThe catalog view a build was given cannot load the bodies pinning needs (Подання каталогу, надане збірці, не може завантажити тіла, потрібні для закріплення)
E0109resolve: catalog lookup cannot load resolved recipe and plugin bodiesThe catalog view a build was given cannot load the bodies pinning needs (Подання каталогу, надане збірці, не може завантажити тіла, потрібні для закріплення)
E0110resolve: source-template evaluation failure at lock timeResolving a source: coordinate registers a narrower function set (Розв’язання координати source реєструє вужчий набір функцій)
E0111resolve: source-template parse errorResolving a source: coordinate registers a narrower function set (Розв’язання координати source реєструє вужчий набір функцій)
E0112resolve: source-template references .provides (invalid reverse reference)Resolving a source: coordinate registers a narrower function set (Розв’язання координати source реєструє вужчий набір функцій)
E0113resolve: sub-aggregate inclusion depth exceededThe chain of module imports is deeper than the pin walk descends (Ланцюжок імпортів модулів глибший, ніж спускається обхід закріплення)
E0114resolve: no entity in the catalog matches this URIA reference names no entity the catalog holds (Посилання не вказує на жодну сутність, яка є в каталозі)
E0115compactform: ambiguous dispatch — $mode requiredA compact-form schema declares a field literally named type (Схема в компактній формі оголошує поле з буквальною назвою type)
E0116compactform: constraint not valid for declared typeA compact-form constraint does not apply to the type it was written on (Обмеження компактної форми не застосовне до типу, на якому його написано)
E0117compactform: $jsonschema content invalidA $jsonschema: escape carries content that is not a schema (Екранування $jsonschema: містить вміст, який не є схемою)
E0118compactform: cross-document $ref carries a registry host; reference the library by identityA $ref: addresses a library by registry location ($ref: адресує бібліотеку за розташуванням у реєстрі)
E0119compactform: $ref unresolvableA $ref: is not written in a form the compiler can resolve ($ref: записано не у формі, яку компілятор може розв’язати)
E0120compactform: unknown keywordA compact-form schema uses a keyword the compact form does not know (Схема в компактній формі використовує ключове слово, якого компактна форма не знає)
E0121compactform: cross-document $ref target not foundA $ref: is not written in a form the compiler can resolve ($ref: записано не у формі, яку компілятор може розв’язати)
E0122deprecation: build consumes a deprecated entityThe build consumes an artifact its publisher has deprecated (Збірка використовує артефакт, який його видавець позначив як застарілий)
E0123docscache: artifact is not a documentation bundleA resolved artifact is not a documentation bundle (Розв’язаний артефакт не є пакетом документації)
E0124docscache: page not found in documentation bundleСторінка відсутня в пакеті документації
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 (Робочий простір перебуває в режимі офлайн, а крок потребує мережі)
E0126externalinputs: acquisition is disabled for unpinned inputsA render requests an external input the lockfile does not pin (Рендеринг запитує зовнішній вхід, не закріплений у lockfile)
E0127externalinputs: fetched bytes mismatch the pinned digestFetched bytes do not match a pinned digest (Завантажені байти не відповідають закріпленому дайджесту)
E0128externalinputs: URL scheme is not allowedAn external input’s URL uses a scheme that is not allowed (URL зовнішнього входу використовує недозволену схему)
E0129externalinputs: store blob mismatches its pinned recordA stored external input no longer matches its record (Збережений зовнішній вхід більше не відповідає своєму запису)
E0130lockfile: out of date; it no longer matches what its Release resolves toThe lockfile no longer matches what the release resolves to (Lockfile більше не відповідає тому, у що розв’язується реліз)
E0131lockfile: file failed schema validationThe lockfile does not satisfy its schema (Lockfile не відповідає своїй схемі)
E0132oci: manifest has multiple layers of the expected content media typeA manifest carries no layer of the expected kind, or more than one (Маніфест не містить шару очікуваного виду або містить більше одного)
E0133oci: cached manifest digest mismatchFetched or cached bytes do not match the digest committed for them (Завантажені або кешовані байти не збігаються з дайджестом, зафіксованим для них)
E0135oci: content digest mismatchFetched or cached bytes do not match the digest committed for them (Завантажені або кешовані байти не збігаються з дайджестом, зафіксованим для них)
E0136oci: network unreachableThe registry could not be reached (Не вдалося зв’язатися з реєстром)
E0137oci: artifact not found at remote sourceAn artifact is not at the source the build was told to find it (Артефакт відсутній у джерелі, де збірці вказано його шукати)
E0138oci: authentication required or failedThe registry will not serve an artifact without credentials it accepts (Реєстр не віддає артефакт без облікових даних, які він приймає)
E0139oci: tag already published with different contentТег уже опубліковано з іншим вмістом
E0140oci: manifest has no layer of the expected content media typeA manifest carries no layer of the expected kind, or more than one (Маніфест не містить шару очікуваного виду або містить більше одного)
E0141oci: distinct catalog identities map to the same OCI repository locationTwo catalog identities publish to one repository location (Дві ідентичності каталогу публікуються в одне розташування репозиторію)
E0142oci: referrer discovery could not be completedThe registry could not answer what is attached to an artifact (Реєстр не зміг відповісти, що прикріплено до артефакту)
E0143oci: unknown entity kind for mediatype dispatchAn entity kind has no artifact media type (Вид сутності не має медіатипу артефакту)
E0144cached signature bundle does not match its recorded digestA cached signature bundle does not match the digest recorded for it (Кешований пакет підпису не збігається із записаним для нього дайджестом)
E0145plugin reference is not a Plugin entityA plugin reference is not a Plugin entity (Посилання на плагін не є сутністю Plugin)
E0146circular reference expansionПосилання на бібліотеку розгортається саме в себе
E0147registrytrust: advertised trust config is malformedРеєстр надає документ довіри, який не вдається прочитати як такий
E0148registrytrust: registry advertises no trust configРеєстр не публікує документа довіри
E0149attachment name is a near miss for a declared slotНазва вкладення на одне редагування відрізняється від оголошеного слота
E0150attachment does not conform to its declared slot shapeAttachment does not conform to its declared slot shape (Прикріплення не відповідає оголошеній формі слота)
E0151component declared in more than one boundary: declare each component in exactly one boundaryA component is placed in more than one boundary (Компонент розміщено в більш ніж одній межі)
E0152duplicate Aggregate/Manifest identity (metadata.name) in the Release directoryThe Release directory declares one Aggregate or Manifest twice (Каталог Release оголошує один Aggregate або Manifest двічі)
E0153feature merge conflict: reconcile the Aggregate and Release declarations for the featureA feature attached by both the Aggregate and the Release cannot be merged (Функцію, підключену і в Aggregate, і в Release, неможливо об’єднати)
E0154the compiler's own views of the catalog disagreeA guard needs a catalog entity the build resolved and cannot see (Перевірці потрібна сутність каталогу, яку збірка розв’язала, але не бачить)
E0155duplicate delivery key across inject sourcesDuplicate delivery key across inject sources (Дублікат ключа доставки серед джерел inject)
E0156invalid inject key: the from-key must name a provides key its source publishesInject from key is not in the target’s provides (Ключ from в inject відсутній у provides цілі)
E0158invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go templateA {{ .parameters.* }} reference cannot be interpolated (Посилання {{ .parameters.* }} неможливо інтерполювати)
E0160manifest annotation bindings collide on same Feature path+pillarДві прив’язки анотацій Manifest конкурують за один слот маршрутизації
E0161manifest annotation binding uses reserved prefixA Manifest annotation binding claims the reserved aggrega.ai/ prefix (Прив’язка анотації в Manifest претендує на зарезервований префікс aggrega.ai/)
E0162missing required feature: attach a Feature of the required type to the componentRequired feature not attached (Обов’язкову функцію не приєднано)
E0163required uses socket not populatedОбов’язковий сокет uses: не заповнено
E0164parameter contract violatedParameter type mismatch / contract violation (Невідповідність типу параметра / порушення контракту)
E0165required parameter not suppliedParameter type mismatch / contract violation (Невідповідність типу параметра / порушення контракту)
E0167Recipe publishes a provides key its Component does not declareСутність Recipe публікує ключ provides, якого не оголошує її Component
E0168authored pillar does not conform to its declared schemaAuthored values or infra do not conform to the declared schema (Написані values або infra не відповідають оголошеній схемі)
E0169self-inject on component without spec.inject allowlistSelf-inject on a component without an allowlist (Self-inject у компонента без списку дозволених); Self-inject mechanism not in the component’s allowlist (Механізму self-inject немає у списку дозволених компонента)
E0170aggregate/manifest reference unresolvableA Release’s aggregate: or manifest: reference resolves to nothing (Посилання aggregate: або manifest: у сутності Release ні на що не розв’язується)
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 (Сокет uses не оголошено в usesSchema сутності-власника)
E0172release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary)Release дійшов до розв’язання, не пройшовши шлях завантаження
E0173declared parameter is read by no reference in the AggregateОголошений параметр ніщо не читає
E0174uses socket name is a near miss for a declared socketНазва сокета uses: на одне редагування відрізняється від оголошеного сокета
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 (Файл неможливо прочитати, або його байти не розбираються)
E0176signing: keyless signing requires a live identity provider, Fulcio, and RekorKeyless signing was asked for without the services it needs (Безключове підписування запитано без потрібних йому сервісів)
E0177signing: no signature found for an artifact that requires oneAn artifact that must be signed carries no signature (Артефакт, який має бути підписаний, не має підпису)
E0178signing: keyless verification requires at least one trusted identityA keyless trust policy names no acceptable signer (Політика довіри без ключа не називає жодного прийнятного підписувача)
E0179signing: signature does not verifyA detached signature does not verify against the key supplied (Відокремлений підпис не проходить перевірку наданим ключем)
E0180signing: signature bundle does not verifyA signature does not verify (Підпис не проходить перевірку)
E0181signing: signing policy requires a signature for this artifact kind; refusing to push unsigned contentAn unsigned publish targets a registry or a policy that requires a signature (Непідписана публікація спрямована до реєстру або політики, що вимагає підпису)
E0182signing: cannot load pinned trust rootThe pinned trust root cannot be read (Закріплений корінь довіри неможливо прочитати)
E0183signing: registry requires signatures; refusing to push unsigned contentAn unsigned publish targets a registry or a policy that requires a signature (Непідписана публікація спрямована до реєстру або політики, що вимагає підпису)
E0184signing: unsupported held-key typeA pinned verification key is not the key profile the verifier accepts (Закріплений ключ перевірки не відповідає профілю ключа, який приймає верифікатор)
E0185signing: signature identity is not trusted for this registryA signature verifies but its signer is not one the registry trusts (Підпис проходить перевірку, але його підписант не належить до тих, кому довіряє реєстр)
E0186no source adapter serves the source kindsource: сутності Recipe називає тип, який ніщо не вміє отримати
E0187cacheslot: empty workspaceRootA source artifact is cached without a workspace root to anchor it (Артефакт джерела кешується без кореня робочого простору, до якого його прив’язати)
E0188artifacts entry: shape must be a string scalar or {$import: <local-path>}An inline-or-import field is written in neither shape (Поле «вбудоване або імпортоване» не записане в жодній із двох форм)
E0189artifactlibrary: entry must be a mapping of filename to a string bodyA library entry’s body is not the shape that library holds (Тіло запису бібліотеки не має форми, яку містить ця бібліотека)
E0190schemalibrary: forbidden JSON Schema keywordA schema uses a JSON Schema keyword the library does not admit (Схема використовує ключове слово JSON Schema, яке бібліотека не допускає)
E0191mappinglibrary: entry body must be a string scalarA library entry’s body is not the shape that library holds (Тіло запису бібліотеки не має форми, яку містить ця бібліотека)
E0192a document nests too many levels deepA document nests deeper than the reader will descend (Документ вкладений глибше, ніж спускатиметься читач)
E0193parameters: shape must be an inline object or {$import: <local-path>}A Release’s parameters: block is written in neither of its two shapes (Блок parameters: сутності Release записано в жодній із двох його форм)
E0194schemalibrary: template not foundA $instantiate: reference cannot be resolved (Посилання $instantiate: неможливо розв’язати)
E0195schemalibrary: template parameter missingA $instantiate: reference cannot be resolved (Посилання $instantiate: неможливо розв’язати)
E0196schemalibrary: template parameter type mismatchA $instantiate: reference cannot be resolved (Посилання $instantiate: неможливо розв’язати)
E0197valuesmapping: shape must be a string scalar or {$import: <path-or-library-identity>}An inline-or-import field is written in neither shape (Поле «вбудоване або імпортоване» не записане в жодній із двох форм)
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 (Провайдер оголошує загальновідому анотацію в області, яку він не рендерить)
E0199workloadlibrary: entry body must be a string scalarA library entry’s body is not the shape that library holds (Тіло запису бібліотеки не має форми, яку містить ця бібліотека)
E0200workload: shape must be a string scalar or {$import: <path-or-library-identity>}An inline-or-import field is written in neither shape (Поле «вбудоване або імпортоване» не записане в жодній із двох форм)
E0201assertion name declared twice across the extends chainІм’я твердження оголошено двічі в ланцюжку extends:
E0202cyclic extends chainCyclic extends chain (Циклічний ланцюжок extends); Cyclic extends on Components or Features (Циклічний extends у Components або Features)
E0204FeatureRecipe: valuesMapping requires sourceA FeatureRecipe’s valuesMapping requires source (valuesMapping у сутності FeatureRecipe потребує source)
E0205inheritance merge failedЛанцюжок extends: неможливо зібрати
E0207recipe output-component-labels constraint: key is also declared in outputLabelsA promoted component label is also declared literally (Перенесену мітку компонента також оголошено літерально)
E0208recipe output-labels constraint: key uses a reserved namespaceAn output-label key uses a reserved namespace (Ключ мітки виводу використовує зарезервований простір імен)
E0209Recipe: valuesMapping requires sourcevaluesMapping потребує source
E0210Recipe: at least one input kind requiredAt least one input kind must be present (Має бути присутній щонайменше один вид вхідних даних)
E0211filename collision across input kinds: two input-kind blocks produced a file under one output nameEmission-time filename collision across input kinds (Колізія імен файлів між видами вхідних даних під час виведення)
E0212workload attachment slot is not referenceableWorkload посилається на слот, заповнення якого не публікує локатора
E0213workload featuresSchema cross-check failedВкладення Workload називає слот, який сутність не оголошує, або спосіб доставки, який слот забороняє
E0214workload validation failedA Workload does not satisfy the Workload schema (Сутність Workload не відповідає схемі Workload)
E0215document envelope validation failedYAML anchor aliased inside its own content (Якір YAML використано як псевдонім усередині його власного вмісту); Divergent Release (extends + aggregate pointer) (Розбіжний Release (extends + вказівник aggregate))
E0216validator/jsonschema: x-aggrega extension evaluation failedAn x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (Предикат x-aggrega-when: або x-aggrega-validate: неможливо обчислити)
E0218validator/jsonschema: schema resolution failedОголошену схему неможливо розв’язати
E0220extends chain exceeds maximum depthЛанцюжок extends: перевищує межу глибини
E0221merger: invalid merge inputВласна перевірка вхідних даних кроку злиття схем
E0222registry alias matches more than one hostA registry alias matches more than one 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 (Прив’язка плагіна задає ключ, який не читає сокет, до якого вона під’єднується)
E0224workspace configuration is invalidThe workspace configuration is invalid (Конфігурація робочого простору недійсна)
E0225capability is bound to more than one provider pluginA capability is bound to more than one provider plugin (Можливість прив’язано більш ніж до одного плагіна провайдера)
E0226registry alias is already used by another hostПсевдонім реєстру вже прив’язано до іншого хоста
E0227a governance attachment declares no role or an unknown roleA governance attachment declares no role, or one that is not a known role (Підключення governance не оголошує ролі або оголошує невідому роль)
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 (Прив’язка плагіна задає ключ, який не читає сокет, до якого вона під’єднується)
E0229position out of rangeПозиція в редакторі виходить за межі документа
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 (Записаний дайджест довіреного плагіна не збігається з кешованим артефактом)
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 (Плагін, записаний як довірений шлюз, більше не підключено)
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 (Плагін повернув щось, що не має форми, яку читає гніздо)
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 (Провайдер указав для учасника каталог, який не є одним каталогом)
E0251recipe source is an empty string, which names neither sourceless mode nor sourced modesource: у Recipe — порожній рядок
E0252artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested underФайл пакета ArtifactLibrary не називає власного файлу під ключем, за яким його імпортовано
E0253annotation binding does not resolve against its target FeatureAnnotation binding does not resolve against its target Feature (Прив’язка анотації не розв’язується щодо цільової Feature)
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 (Прив’язане значення анотації не відповідає схемі цільової Feature)
E0255annotation routes through a pillar its authoring side may not useAn annotation routes through a pillar its authoring side may not use (Анотація спрямовується через стовп, який її бік авторства не може використовувати)
E0256annotation binding declares one path in both pillar listsПрив’язка анотації оголошує один шлях в обох списках опор
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 (Оголошений контракт схеми неможливо прочитати як схему)
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 з областю межі приєднано лише до компонента)
E0260component placed in no boundary: name it under a boundary's `components`, or place the sub-module that contributes it under `aggregates`Компонент, який містить композиція, не розміщено в жодній межі
E0261boundary names a component the composition does not hold: correct the name, or remove the entryМежа називає компонент, якого композиція не містить
E0262component identity cannot be the name its emitted resources are stamped with: rename the componentComponent identity cannot be stamped on what it emits (Ідентичність компонента не можна проставити на тому, що він виводить)
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 (Ціль не прийме ім’я, похідне від авторської ідентичності)
E0264provider guest never accepted a component identity the compiler composed for itA provider never accepted a name the compiler composed (Провайдер так і не прийняв ім’я, складене компілятором)
E0265provider does not support the node's input kindworkload: потребує провайдера, здатного до синтезу
E0266a schema `$import:` could not be appliedA schema $import: cannot be applied (Неможливо застосувати $import: схеми)
E0267a schema block declares a key that names no data pillarA schema block names a key that is not a data pillar (Блок схеми називає ключ, який не є стовпом даних)
E0268reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokensПовторне складання провайдера отримує одиницю, якої не створило його власне розрізання
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 (Провайдер повернув два вихідні файли за одним шляхом)
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 (З’єднання зв’язку провайдера називає вихідний файл, який так і не було виведено)
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 (Виведення файлу кроком конвеєра не містить файлу)
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 (Крок конвеєра оголошує вид виведення, який контракт не визначає)
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 suppliesA template reads a rendered name the node’s provider does not report (Шаблон читає відрендерене ім’я, яке провайдер вузла не повідомляє)
E0274the plugin identity recorded as trusted no longer matches what this resolution reportsA gate recorded as trusted resolves to a different identity (Шлюз, записаний як довірений, розв’язується в іншу ідентичність)
E0275the edit was refused because the resulting document would not be valid, and nothing was writtenРедагування створило б документ, який відхиляє його схема
E0276the version being published changes the published predecessor in a way the documented evolution rubric objects toЗміна, що публікується, порушує те, що дозволяє рубрика еволюції
E0277an annotation key on the entity uses a prefix the platform reservesКлюч анотації використовує префікс, зарезервований платформою
E0278the entity's name does not follow the documented name shape for its kindНазва сутності не відповідає формі, якої очікує її вид
E0279a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot followСхема використовує динамічне посилання, яке неможливо розв’язати заздалегідь
E0280a schema in the entity declares an identifier of its own, where the platform owns that schema's identityСхема оголошує ідентифікатор, яким володіє платформа
E0281the entity's category label does not match the category directory the entity is filed underМітка категорії сутності Component і її каталог називають різні категорії
E0282the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchemaРозширення схеми записано безпосередньо у вміст схеми
E0283the Plugin entity declares no runtime resource cap of its own, so the platform defaults applyСутність Plugin не фіксує жодного обмеження виконання, тож застосовуються обмеження платформи
E0284an attachment slot admits only secret material and does not declare that it handles itСлот вкладення приймає лише секретні дані, не вказуючи, що обробляє їх
E0285the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refusedСутність Recipe публікує ключ provides, якого не оголошує її сутність Component, — перевірка під час публікації
E0286the version bump being published is smaller than the evolution check's classification of the change requiresЗапропонована версія — менше підвищення, ніж вимагає зміна
E0287the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring filesІмпорт зупинився на півдорозі перекладу джерела
E0288a plugin has no expression for a construct this build declaresA workload declares a form compose cannot express (Робоче навантаження оголошує форму, яку compose не може виразити); A container declares a field compose has no primitive for (Контейнер оголошує поле, для якого в compose немає примітива); An omits entry names a kind or a namespace a compose file does not have (Запис omits називає вид або простір імен, якого немає у файлі compose); An omits entry names a namespace a CloudFormation template does not have (Запис omits називає простір імен, якого немає в шаблоні CloudFormation); A rule reads a bound CloudFormation parameter by name (Правило читає прив’язаний параметр CloudFormation за назвою); The assembled CloudFormation stack cannot carry a transform (Зібраний стек CloudFormation не може містити трансформацію)
E0289a plugin could not resolve something it requires to exactly one valueA health probe cannot be turned into a compose healthcheck (Перевірку справності неможливо перетворити на healthcheck для compose); A configmap volume has no file behind it (За томом configmap немає файлу); What an omits entry left out is still named by the compose file (Те, що виключив запис omits, досі називається у файлі compose); What an omits entry left out is still named by a CloudFormation template (Те, що виключив запис omits, досі називається в шаблоні CloudFormation); A valuesMapping key names no parameter of a sourced CloudFormation template (Ключ valuesMapping не називає жодного параметра підключеного шаблону CloudFormation); Another component references a CloudFormation parameter a sourced template’s binding filled (Інший компонент посилається на параметр CloudFormation, який заповнила прив’язка підключеного шаблону); Two components order one pair of transforms oppositely (Два компоненти впорядковують одну пару трансформацій протилежно); A cross-boundary reference has no consuming stack to be written into (Для посилання між межами немає стека-споживача, у який його можна записати); A synthesized StatefulSet has no single service to govern it (Для синтезованого StatefulSet немає єдиного сервісу, який ним керує)
E0290two things a plugin produced occupy one name in its outputAn authored export name is one the build derives for a cross-stack reference (Написане ім’я експорту збігається з тим, яке збірка виводить для посилання між стеками); The output a cross-stack reference publishes on already carries an Export (Вихід, через який публікується посилання між стеками, вже містить Export); Two entries reach one stack output name (Два записи досягають одного імені виходу стека); A CloudFormation fragment writes one key twice (Фрагмент CloudFormation записує один ключ двічі); Two rendered resources land at one output file (Два відрендерені ресурси потрапляють в один вихідний файл)
E0291a plugin has no representation for a value it was givenA published port declares a transport compose cannot spell (Опублікований порт оголошує транспорт, який compose не може записати); A resources quantity cannot be converted to a compose value (Кількість ресурсів неможливо перетворити на значення compose); A resource quantity the helm provider emits is not a quantity (Кількість ресурсу, яку виводить провайдер helm, не є кількістю); A service type the helm provider cannot render (Тип сервісу, який провайдер helm не може відрендерити); A Kubernetes version the helm provider cannot render a chart for (Версія Kubernetes, для якої провайдер helm не може відрендерити чарт); A value bound to a CloudFormation parameter cannot take the parameter’s type (Значення, прив’язане до параметра CloudFormation, не може набути типу параметра); A value bound to a CloudFormation parameter is one its constraints refuse (Значення, прив’язане до параметра CloudFormation, відхиляють його обмеження); A secret bound to a CloudFormation parameter would be written into the template (Секрет, прив’язаний до параметра CloudFormation, було б записано в шаблон); A dynamic reference is bound where CloudFormation does not resolve it (Динамічне посилання прив’язано там, де CloudFormation його не розв’язує); A cross-boundary reference was spliced into a longer string (Посилання між межами вставлено в довший рядок)
E0292a plugin reported a failure that none of the declared kinds namesA plugin reported a failure it did not classify (Плагін повідомив про збій, який не класифікував)
E0293wasm: guest plugin named a condition the socket does not declareA plugin named a condition the socket does not declare (Плагін назвав умову, яку сокет не оголошує)
E0294components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component's identityДві підсистеми оголошують компонент під однією назвою
E0295library reference: a reference to a library entry carries no whitespace or line breakA reference to a library entry carries whitespace (Посилання на запис бібліотеки містить пробільні символи)
E0296release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never bothЛанки ланцюжка Release не погоджуються щодо форми маршрутизації
E0297inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes toДочірній Release успадковує каталог межі, що розв’язується туди, куди записує батьківський
E0298oci: published bundle carries no entity documentA published bundle holds no entity, or holds two (Опублікований пакет не містить жодної сутності або містить дві)
E0299oci: published bundle carries more than one entity documentA published bundle holds no entity, or holds two (Опублікований пакет не містить жодної сутності або містить дві)
E0300oci: published bundle cannot be unpackedA published artifact cannot be read as an entity (Опублікований артефакт неможливо прочитати як сутність)
E0301oci: published artifact is not an entity documentA published artifact cannot be read as an entity (Опублікований артефакт неможливо прочитати як сутність)
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 (Сутність читає вхідні дані, для яких lock-файл поруч із нею не записує жодного піна)
E0303the entity shares its directory with another entity, and an entity of its kind has a directory of its ownСутність ділить свій каталог з іншою сутністю
E0304a path names content outside the entity's own directoryA path names content outside the entity’s own directory (Шлях вказує на вміст поза власним каталогом сутності)
E0305the files of the entity's local source do not match the pins recorded for them in entity.lockЛокальне джерело більше не відповідає пінам, записаним поруч із його Recipe
E0306plugin artifact not found on this machineФайлу .wasm плагіна немає на цій машині
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 (Значення розмістило б кешований файл поза кешем)
E0308a Feature reaches a component alongside a Feature it declares a conflict withTwo Features declared to conflict reach one component (Дві Features, оголошені конфліктними, досягають одного компонента)
E0309a symbolic link sits among the files an entity carriesСеред файлів, які містить сутність, є символьне посилання
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>`Реєстр додається в офлайн-режимі без політики довіри, яку можна закріпити
E0311reference carries a malformed version pinA version pin is none of the forms a pin takes (Закріплення версії не має жодної з форм, яких набуває закріплення)
E0312a provider socket binding names a capability containing a colon, which no Recipe can selectA provider binding names a capability containing a colon (Прив’язка провайдера називає можливість, що містить двокрапку)
E0313plugins.providers entry names a capability no provider-rendering plugin the build reads servesПрив’язка провайдера називає можливість, яку не обслуговує жоден плагін, що його читає збірка
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 (Плагін зібрано з робочого дерева з незакоміченими змінами)
E0315a connection carries an attachment under a name its socket declares no slot forЗ’єднання несе приєднання під назвою, для якої його сокет не оголошує слота
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 (Вкладення сутності Release бере ім’я вкладення з’єднання)
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 (Вкладення з’єднання сутності Release не вказує тип 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 (Дві прикріплені сутності Features доставляють один ключ, пізніша — через injectMapping своєї FeatureRecipe)
E0319connection alias is already used by another connection of the same componentДва з’єднання одного компонента під одним псевдонімом
E0320a path this operation writes or deletes leads through a link out of the directory it must stay insideA path the operation writes leads through a link out of the directory it must stay inside (Шлях, який записує операція, веде через посилання за межі каталогу, у якому має залишатися)
E0321a file this operation reads leads through a link out of the directory it must stay insideФайл, який читає операція, через посилання веде за межі каталогу, у якому має залишатися
E0323template reads its callers' render facts, but the FeatureRecipe does not set readsCallerRenderFactsA template reads its callers’ render facts without declaring it (Шаблон читає факти рендерингу своїх викликачів, не оголосивши цього)
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 (Посилання на інший файл веде за межі каталогу, у якому воно має залишатися)
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 (Провайдер повідомив факт рендерингу, значення якого не є списком)
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 factsA pipeline step reads its callers’ render facts (Крок конвеєра читає факти рендерингу своїх викликачів)
E0327template indexes a map with a key the map does not holdA template indexes a map with a key the map does not hold (Шаблон індексує мапу ключем, якого мапа не містить)
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 (Приєднання, записане під іншим ім’ям, підходить до слота, який його компонент залишає порожнім)
E0329a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names oneЗ’єднання і ціль, до якої воно веде, не називають один ключ
E0330signing: the references named together need different signing credentials, so nothing was signedReferences signed together need different signing credentials (Посилання, що підписуються разом, потребують різних облікових даних для підпису)
E0331signing: no verified signature is recorded for an artifact that requires oneNo verified signature is recorded for an artifact that requires one (Для артефакту, який потребує підпису, не записано перевіреного підпису)
E0332signing: the recorded signature was made for a different artifactA recorded signature was made for a different artifact (Записаний підпис створено для іншого артефакту)
E0333signing: a recorded signature is not the one a pull would recordA recorded signature is not the one a pull would record (Записаний підпис не той, який записало б витягування)
E0334an omits entry left out nothing the source renderedAn omits entry left out nothing the source rendered (Запис omits не виключив нічого з того, що відрендерило джерело)
E0335provider does not support omitsThe provider does not support omits (Провайдер не підтримує 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 (Кількості пропущеного від провайдера не відповідають переданим йому записам omits)
E0337no importer plugin version satisfies the plugins.importer entry's version pinA plugins.importer entry pins a version of its importer the catalog does not hold (Запис plugins.importer закріплює версію свого імпортера, якої немає в каталозі)
E0338importer is attached by more than one plugins.importer entryAn importer is attached by more than one plugins.importer entry (Імпортер під’єднано більш ніж одним записом plugins.importer)
E0339more than one importer recognises the sourceMore than one importer recognises the source (Джерело розпізнає більше ніж один імпортер)
E0340a name this operation writes holds a path segment Windows cannot hold as writtenA name the operation writes holds a part Windows cannot hold (Ім’я, яке записує операція, містить частину, яку 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 (Імпортеру, що не оголошує шаблонів файлів, передано каталог)
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 (Жоден файл у каталозі не відповідає шаблонам файлів імпортера)
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 (Файл, прочитаний із каталогу, і файл, названий у with.sources імпортера, мають однакову назву)
E0344an entry this publication carries cannot be used on WindowsA published archive carries an entry Windows cannot use (Опублікований архів містить запис, який Windows не може використати)
E0345a container declares one environment variable twiceA container gives one environment variable two values (Контейнер задає одній змінній середовища два значення)
E0346a Component's annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance's metrics need a credentialАнотація метрик сутності Component і її ключ provides не узгоджуються
E0347template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFactsA template reads its targets’ render facts without declaring it (Шаблон читає факти рендерингу своїх цілей, не оголосивши цього)
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 factsA pipeline step reads its targets’ render facts (Крок конвеєра читає факти рендерингу своїх цілей)
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 (Ціль імпорту називає можливість, до якої не прив’язується жоден Recipe у каталозі)
E0350no importer recognises the sourceNo importer recognises the source (Жоден імпортер не розпізнає джерело)
E0351provider does not support boundary artifactsThe provider does not support boundary artifacts (Провайдер не підтримує артефакти межі)
E0352boundary output directory does not name a directory beneath the output rootA boundary’s output directory is not a directory beneath the output root (Вихідний каталог межі не є каталогом усередині кореня виводу)
E0353boundary-level Feature instance name is not a directory nameA boundary-level Feature is named . or .. (Feature рівня межі має назву . або ..)
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 (шаблон зробив більше, ніж скопіював значення, прочитане з міжмежового зв’язку)
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 (Доставка ін’єкції не є списком записів)
E0356suspend requires form: scheduledA workload suspend: is set on a form other than scheduled (Поле призупинення workload задано у формі, відмінній від запланованої)
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 (Зіставлення name у сутності Manifest не називає нічого у збиранні)
E0358uses edge target names a component its module does not exportA uses target names a module’s component the module does not export (Ціль uses називає компонент модуля, який модуль не експортує)
E0359no source adapter is registered in this program for the source kindNo source adapter is registered in this program for a source kind (У цій програмі не зареєстровано адаптера джерела для типу джерела)
E0360the netrc file could not be readThe netrc file cannot be read (Файл netrc не вдається прочитати)
E0361the source URL carries a credentialA source URL carries a credential (URL джерела містить облікові дані)
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 (Запис ін’єкції на з’єднанні містить літерал)
E0363annotation subkey is not routed by the annotation's bindingAn annotation subkey is not routed by its binding (Підключ анотації не спрямовується її прив’язкою)
E0364a value template failed while it ranA value template failed while it ran (Шаблон значення зазнав помилки під час виконання)
E0365boundary-level Feature's output is routed to a dispatch path nothing assemblesA boundary-level Feature’s output reaches no assembled file (Вивід сутності Feature рівня межі не потрапляє до жодного зібраного файлу)
E0366FeatureRecipe injectMapping output could not be read as a dictionary of deliveriesAn attached Feature’s injectMapping output cannot be read (Не вдається прочитати вивід injectMapping приєднаної сутності Feature)
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 (Просте значення анотації не спрямовується рівно в один шлях її прив’язки)
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 (Вивід injectMapping приєднаної сутності Feature записує доставки під ключем, за яким нічого не доставляється)
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 (Шаблон читає й ітерує шлях, який нічого не містить)
E0370a pipeline declares one step id twiceA pipeline declares one step id twice (Конвеєр оголошує один ідентифікатор кроку двічі)
E0371catalog document declares a kind a catalog does not holdA catalog document declares a kind a catalog does not hold (Документ каталогу оголошує вид, якого каталог не містить)
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 (Запис ін’єкції на приєднаній сутності Feature містить літерал)
E0373a document declares an API version this compiler no longer readsA document declares an API version this compiler no longer reads (Документ оголошує версію API, яку цей компілятор більше не читає)
E0374a plugin declares a plugin ABI version this compiler no longer speaksA plugin declares a plugin ABI version this compiler no longer speaks (Плагін оголошує версію ABI плагінів, яку цей компілятор більше не підтримує)
E0375oci: artifact carries a media type this compiler no longer readsAn artifact carries a media type this compiler no longer reads (Артефакт має тип медіа, який цей компілятор більше не читає)
E0376egress: the server did not answer in timeA server did not answer in time (Сервер не відповів вчасно)
E0377registry: the repository listing did not end in timeA registry’s repository listing did not end in time (Перелік репозиторіїв реєстру не завершився вчасно)
E0378oci: the registry kept asking to slow downA registry kept asking to slow down (Реєстр продовжував просити сповільнитися)

Домен лінтера (не фатальний)

Компілятор суворо без власної позиції щодо виконання. Він ніколи не зупиняє збірку через шаблони, які лише підозрілі, — невикористані значення, осиротілі секрети, від’єднані цілі. Щонайбільше такий шаблон спричиняє попередження — власне попередження збірки для небагатьох випадків, описаних вище в розділі «Умови, які не зупиняють збірку», як-от оголошений параметр, який ніщо не читає, — а решта належать до домену лінтера, де підприємства за власним вибором підключають Wasm-плагіни, що забезпечують дотримання їхніх власних домовленостей.

Осиротілі облікові дані

Сутність Feature з обліковими даними, прикріплена без контракту доставки inject:, не є помилкою компіляції. Ядро компілятора зберігає оголошення в графі IR і не видає жодного попередження. Корпоративні плагіни лінтера можуть виявляти цей шаблон і попереджати про нього; корпоративні рендерери також можуть неявно монтувати осиротілі секрети згідно з власними домовленостями Black-Box. Оскільки обидва тлумачення допустимі, ядро компілятора не стає на жоден бік.